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DTP ON THE ARCHIMEDES 

All RISC USer subscribers should have received 
with the June issue of RISC User a copy of our 
promotional leaflet on Ovation, BEEBUG's 
new desktop publishing package. Desktop 
publishing (or simply DTP as it is known) has 
become an important application on most 
computer systems, and a real choice is now 
available to Archimedes users, with Acorn 
DTP, Computer Concepts’ Impression, 
Ovation from BEEBUG and Tempest from 
Clares Micro Supplies. Indeed, so powerful 
and versatile is the new generation of DTP 
software that it is increasingly questionable 
whether word processors as we know them 
are still an adequate and cost effective tool. 


As some readers may be aware we use DTP 
very extensively ourselves to originate both 
BEEBUG and RISC User magazines, the Retail 
Catalogue, and many other items. We have 
been doing this for well over three years using 
professional quality software on Apple 
Macintoshes (neither the Archimedes nor 
suitable DTP software were available when we 
started). We have come to appreciate the 
tremendous improvement that DTP brings to 
almost any printed page, and indeed, DTP can 
rapidly become quite addictive. 


When it came to designing our own DTP 
software for the Arc we naturally set out to 
produce a package which was as easy and 
intuitive to use, and equal in quality to the 
Macintosh systems with which we are familiar. 
We also sought to improve on certain features 
which our experience had shown to be too 
limited. 


The result is Ovation, a DTP package for the 
Arc with a truly professional feel to it and yet 


still easy to use (and to learn). The detailed 
specification is given in the leaflet referred to 
earlier, and we certainly believe we have 
achieved our aims. 


| recently took part in an Acorn Roadshow, 
visiting a number of venues in England and 
Scotland, talking about and demonstrating 
Ovation to teachers and advisers concerned 
with a wide variety of age groups and 
abilities. The response to Ovation from all 
those | spoke to was very encouraging, 
particularly with regard to its ease of use. And 
the more | used Ovation during the course of 
the roadshow, the more enthusiastic | became 
about it as a user. 


As | said earlier given the availability of DTP 
packages like Ovation, it is difficult to 
understand why anyone would wish to 
continue using a conventional word processor. 
DTP offers virtually all the features of word 
processing, and so much more. 


Well | hope | have said enough to convince 
you both of the value of DTP as a major tool 
for any Archimedes user, and to encourage 
you to give serious consideration to Ovation 
as a high quality, professional product. 


To help you further, we have prepared a demo 
disc of Ovation which costs just £5 (including 
VAT and p&p) which will be sent to any 
potential purchaser on request. Furthermore, 
your £5 can be entirely recouped if you 
subsequently order the full Ovation package 
from us. What have you got to lose? Both the 
demo disc and the full Ovation package are 
available now. 

M.CW. 
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MIDNIGHT DRIVERS 


Midnight Graphics, a name new to the 
Archimedes world - see this month’s review 
on DTP Resources - has announced a 
number of colour printer drivers. These are 
multi-tasking sprite printers rather than 
conventional RISC OS printer drivers. As a 
result, printing can take place in the 
background, while you get on with other 
work, 


Sprites can also be scaled before printing, 
and colour patterns can be selected which 
are claimed to give better intermediate 
colours than those provided by Acorn or Ace. 
Printers covered are the Star LC10 and 
XB24, the Citizen Swift 9 and 24 pin, the 
Integrex Colourjet 132, the HP Paintjet, and 
the Juki 5520. Sprites can also be printed in 
single, double or quad density. Each printer 
driver costs £29.95 inc. VAT. Midnight 
Graphics is at 5 Victoria Lane, Whitefield, 
Manchester M25 6AL, tel. 061-766 8523. 


time called FlexiFile. This is described as a 
multi-tasking database designed specifically 
for small businesses, education and home 
hobbyists looking for flexibility at a low price. 


FlexiFile, which is controlled by a so-called 
video style interface for ease of use, is 
scheduled for release in early June, and will 
retail at £149.95 ine. VAT. 


Minerva has also released a word processor 
called EasiWord, which with its potential for 
large letter displays is claimed to make it 
ideal for use with younger children or those 
who are partially sighted. Text, background, 
and highlights can be in any colour, 
enhancing its appeal for children. EasiWord 
will also be available early June for £39.95 
inc, VAT. For more information on both 
products contact Minerva Software, Minerva 
House, Baring Crescent, Exeter EX1 1TL, or 
tel. (0392) 437756 (note the new address). 


NEW SPREADSHEET FROM ACORN 


Details of Acorn’s long awaited spreadsheet, 
called Schema, have begun to emerge. 


DATA LOGGING FOR THE 
ARCHIMEDES 


One area where the Archimedes has yet to 
match the BBC micro is in the area of data 
logging. G.A.Herdman Educational is 
helping to change that by releasing an 
Archimedes version of its Recording Digital 
Thermometer, though an I/O podule is an 
essential prerequisite. The package includes 
twin ready-calibrated temperature probes, 
large-character digital display, graphical 
displays covering time intervals from 2 
minutes to 18 hours, optional printer output, 
data storage for future analysis and more. 
The probe units fit the analogue port and are 
supplied with 3 metre leads as standard. The 
twin probe version costs £35.99 inclusive, 
and there is a single probe version for 
£29.99. Contact G.A.Herdman Educational, 
43 St Johns Drive, Clarborough, Retford, 
Notts DN22 9NN, tel. (0777) 700918. 


MINERVA ANNOUNCES DATABASE 
AND WORD PROCESSOR 


Not content with System Delta Plus, and the 
more sophisticated Multistore, software 
house Minerva has announced yet another 
database system for the Archimedes, this 


Designed specifically for the Archimedes 
(including the A3000) and RISC OS, the 
new spreadsheet package is fully multi- 
tasking, and supports advanced statistical 
and financial features using a WYSIWYG 
display. 


Maximum spreadsheet size has been set at 
32,000 columns by 32,000 rows. Multiple 
worksheets can be linked together, and 
there are built-in facilities for the 
production of graphs and charts, Macro 
programming support enables customised 
spreadsheet applications to be developed 
with ease, with a macro capture facility 
allowing regularly repeated operations to be 
recorded for subsequent playback. 


Extensive printer support is also provided, 
allowing either draft or final copy to be 
produced as required totally under user 
control. More sophisticated report 
generation is possible using the standard 
RISC OS printer drivers. 


The price has not yet been fixed nor the 
release date which is some months away, but 
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Acorn has already been demonstrating pre- 
release versions to interested parties. For 
more information contact. Acorn Computers 
Ltd, Fulbourn Road, Cherry Hinton, 
Cambridge CB1 4JN, tel. (0223) 245200. 


MORE CONTROL SOFTWARE 
FROM BEDFORD 


An impressive enterprise from Bedford 
Modern School has resulted in the release 
of two substantial pieces of control software 
for the Archimedes. Sparkle is an 
application designed for use with I/O 
control devices such as the Deltronics 
control box. A complete programming 
language allows the user to make full use of 
the power of the control box with the 
minimum of ease. Sparkle is fully RISC OS 
compatible and costs £57.44 inc. VAT. 


The second product is an application called 
Robot for complete control of the Alfred 
robot. Again, Robot is fully programmable 
with a host of features. The price is £45.94 
inc. VAT. 


A company called Aietos has been set up by 
Bedford Modern School to market this and, 
it is hoped, further software. As an 
indicator of what they have achieved, 
Aietos took part in Acorn’s recent roadshow. 
For more information contact Aietos at 
Bedford Modern School, Manton Lane, 
Bedford MK41 7NT, tel. (0234) 64331. 


INBETWEENING FROM ACE 


Latest release from that home of graphics 
software, Ace Computing, is a new product 
called Tween. This enables cartoon 
sequences to be created by taking two Draw 
files and with the help of a spreadsheet 
generates all the intermediate images 
which can be used to produce a simple 
animated sequence. 


Tween works with any Draw files, including 
output from Graphbox, Presenter, Euclid 
and other CAD software. Interesting effects 
can also be produced with text using Tween 
to animate output from FontFX (see DTP 
Resources review in this issue of RISC 
USer). The output from Tween is in Ace 
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Film format, allowing it to be used also 
within Genesis. 


Ace Computing expects to release shortly 
the third disc from Elements the 
independent Euclid User Group, while a 
new ray-tracing package, ArcLight is also 
due for release soon. 


Tween is available now at a special 
introductory price of £30.00 inc. VAT from 
Ace Computing, 27 Victoria Road, 
Cambridge CB4 3BW, tel, (0223) 322559. 


ACORN ACROSS THE SEAS 


In an interesting move, Acorn Computers 
has made an agreed bid for the Australian 
based Barsons group, the major distributor 
of Acorn’s products to Australia and New 
Zealand. Acorn believes that this move will 
enable it to expand further an already 
established market (Acorn is a major force 
in education in both countries) with better 
support than ever. 


ECONET TELETEXT SERVER 


Specialist Econet supplier, XOB of Forfar in 
Scotland, has announced an Econet Teletext 
server for RISC OS. This runs as a multi- 
tasking application with the RISC OS 
Desktop on any Archimedes or A3000. Once 
installed, any Acorn computer (including 
BBC micro and Master) can request the 
server to download Teletext pages, which 
the server does via a Morley Teletext 
adaptor. An intelligent queueing system 
means that multiple requests are handled 
with the minimum of delay. The software 
(only) costs £100.05 inc.VAT, or with the 
Morley Teletext adaptor for £235:75 inc. 
VAT. For more details contact XOB, 
Balkeerie, Eassie (by Forfar), Angus, 
Scotland DD8 1SR, tel. (030 784) 364. 


SCANNER FOOTNOTE 


Computer Concepts would like to point out 
that its Scanlight Junior (reviewed in RISC 
User Volume 3 Issue 7) has been based on 
the Mitsubishi unit, rather than the 
Geniscan, which was used for a very few 
early orders. The Mitsubishi unit also has a 
resolution setting (up to 400 dpi). AU 
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SILICON VISION News 


ARCHIMEDES SOFTWARE DEVELOPMENTS, ISSUE 2 


RISC OS SolidTOOLS 
achieve total integration 


SolidTOOLS is the first fully 
integrated environment for 3D CAD, 
Photo-realistic rendering, Interactive 
animation, Programmable animation 
and high resolution hardcopy to 
printers and plotters for the 
Archimedes taking the computer to 
new heights of design productivity 
and performance exceeding the 
capabilities of ‘heavy-weight' 
packages on PC-compatibles and 
workstations which cost considerably 
more. 


The software provides 3D CAD 
facilities for Architectural, 
Engineering and Interior design and 
adopts the industry standard 1st & 3rd 
angle projection technique. for 
drawing simultaneously in plan, front 
and side elevations together with a 
3D projection to view the design from 
any angle. A unique smooth shading 
facility is also provided for instant high 
quality rendering of the design for 
improved presentation. 


An interactive 3D animation facility 
also allows flight-paths for cameras 
and objects to be drawn to create 'fly- 
through’ effects for animated 
sequences to further improve 
presentations or to analyse the 


ergonomics and aesthetic qualities of 
the design. 


The system also boasts breath-taking 
photo-realistic capability using 
advanced ray-tracing techniques 
with object orientated design facilities 
pushing the Archimedes colour 
display hardware to its limits for 
reflections, transparencies, 
shadows, and textures. 


Extensive hardcopy facilities are also 
Provided to output designs to printers 
and all industry standard plotters at 
maximum resolution for high quality 
CAD drawings. 


The powerful RISC OS multi-tasking 
capability also allows greater 
integration with other related 
applications such as DTP and ART 
Software so that 3D shaded images 
may be included in other documents 
for improved presentation. 


An ‘open architecture’ approach also 
allows the importing of externally 
generated designs and programming 
facilities allow access to the high 
performance 3D display functions of 
the package for further customisation 
if required. 


Business Software 


The new range of professional 
business software is now available 
and includes DataVision for true 
relational database management 
which is unique in providing both 
relational data-entry and reporting 
facilities together with integrated 
wordprocessing, mail-merging and 
label printing facilities. The Financial 
Accountant package for business 


accounting also includes DataVision 
and provides a fully integrated 
accounting system. 


ShareHolder for share portfolio 
management & OfficeTOOLS for 
office automation and computer 
controlled presentations further 
extend the range to provide powerful 
serious business software for the 
demanding user. 


All software run in native mode on A300-400 Series & A3000 with RISC OS and are available now. 
SILICON VISION LTD, SIGNAL HOUSE, LYON ROAD, HARROW 
MIDDLESEX HA? 2AG. TEL: 081-422 2274 or 081-861 2173 

FAX: 081-427 5169. TELEX: 918266 SIGNAL G. 


PCB Design Tools 


The recently launched ARC-PCB 
Professional package is the result of 
continuing research & development 
to produce a powerful PCB design 
system which out-performs ‘heavy- 
weight’ PC-based PCB layout design 
systems costing considerably more. 


Features include Automatic routing, 
Rats-nesting,  Multiple-layers, 
Circular, Oval & Surface mount Pads, 
0.001" resolution, 32"x32" maximum 
board size, On-line Help, Fast Zoom/ 
Pan/Redraw, Text & Silkscreen 
facility, Variable Track/Pad/Tex/Grid 
sizes, Hierarchical Part Libraries, 
Block Move/Copy/Rotate/Mirror/ 
Erase options, Component Pulling, 
Clear pad holes, Drilling data, up to 
300,000 components and instant 
editing operations for substantially 
increased productivity. The industry 
standard HP-GL, GRAPHTEC, 
PLOTMATE plotters and printers at 
their highest resolutions are 
supported for high quality PCB 
artwork. An optional GerberPLOT 
driver supporting Photoplotters for 
the highest quality PCB artwork is 
also available. 


SILICON Designs 


Electronic design engineers and 
educational institutions are 
discovering that the Gate Array 
design system from Silicon Vision 
provides a cost effective introduction 
to the world of chip design where 
expensive silicon fabrication facilities 
are not needed but only the design 
facilities for teaching purposes are 
required at a low cost. This avoids the 
expensive trial and error iterations 
with industrial systems during the 
early stages of learning chip design 
skills. 


Further Information 


A free product catalogue detailing all 
our software packages for the 
Archimedes is available on request. 


A Handy Mouse Speed Controller 


Adam Goodfellow describes a handy utility which sits on the icon bar 
for instant adjustment of mouse pointer speed. 


V V hen using Desktop applications, 
situations can arise where the current 
mouse/pointer speed is inappropriate to 
the task in hand. There are two ways 
round this problem: you can configure the 
mouse speed to 1 or 2, and suffer a slow 
mouse when you would rather it was fast, 
or enter Basic and use Basic’s 
MOUSESTEP command to change the 
mouse speed when required. This article 
presents an alternative method in the 
form of a small Wimp application called 
Mouse that resides on the icon bar. 


su? :f 
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white mask 
1 very light grey 
2 med.light grey 
3 medium grey 
8 dark blue 
12 cream 
15. light blue 


Figure 1. Mouse_3 


The utility allows you to switch 
instantly between two mouse speeds, one 
fast setting for normal mouse operation 
and a slow setting for when more precise 
positioning is required. Both speeds can 
be adjusted to any of the five settings 
which are possible, and thus the settings 
can be customised to suit your own 
preferences. This is all achieved by 
clicking on the icon bar icon, which 
changes to indicate the current setting. 
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CREATING THE APPLICATION 

If you have a copy of this month’s 
magazine disc then you can ignore this 
section. To enter the files required for this 
application, you will need to be familiar 
with both the Edit and Paint applications 
(on Applications disc 1). First of all, you 
will need to create a directory called 
!Mouse, in which all files will be saved. 
Then use Edit to create an Obey file and 
enter listing 1. This file should be saved 
into the !Mouse directory under the 
filename !Run. Note that the odd character 
which appears in this listing is above the ‘£” 
on the keyboard (i.e. it is Shift-£) 


Next, enter Basic and type in listing 2. 
Save this as a Basic program with the 
name !RunImage in the !Mouse directory. 
In addition to these files, you need to 
create a sprite file to contain the sprites 
used on the icon bar. There are five sprites 
in all called mouse_1 to mouse_5, all of 
which are of the same basic design. 


First of all, you will need to run Paint 
and create a mode 12 sprite called mouse_3 
23 pixels wide by 18 pixels high, and with a 
mask. The next stage is to call up the sprite 
you have created for editing by double 
clicking. If you look at the large sprite 
(figure 1) you will see that it is marked out 
with a grid, in which areas of the same 
shade are outlined with heavy black lines. 
Attached to each of these shaded areas is a 
number indicating the colour to be used 
(using the default palette). For example, if 
an area is marked 15, then the colour for 
that area is light blue. 


Once you have filled in all the shaded 
pixels, select the colour fill option and 
global fill, and the mask colour from the 
palette. Then click on an unshaded (white) 
part of the sprite to create a mask for the 
sprite. Now that you have created the first 
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A Handy Mouse Speed Controller 


sprite, you can use it as a master for the 
remaining four sprites which can be copied 
from mouse_3 to mouse_l, 
mouse_2, mouse_4 and 
mouse_5. All that remains 
is to edit each sprite to 
give the correct position of 
the dark blue bar to 
indicate the 5 mouse 
speed settings 1 to 5 (as 
shown in figures 1 to 5). 


Once all of the sprites have been 
created you should save the sprites in a 
file as Sprites in the !Mouse directory. 


You should now have 
an application directory 
called !Mouse which 
contains the files !Run, 
!RunImage, and Sprites. If 
you now double-click on 
this application you should 
find that a new icon 
appears on your icon bar. 


USING THE APPLICATION 
Mouse uses all three mouse buttons to 
perform various functions when the 
r pointer is over the Mouse 
icon on the icon bar. The 
Select button is used to 
toggle between the two 
current speed settings. 
The Adjust button is used 
to alter the current speed 
setting (use the Select 
button to identify which 
of the two settings you want to change), 
while the Menu button provides Save and 
Quit options. 


Figure 3. Mouse_2 


Figure 4. Mouse_4— 


The Save option allows 
| you to save the current 
speed to CMOS RAM so 
that it becomes the default 
speed. You will notice that 
as you press the Select or 
Adjust buttons, the icon on 
~ the-icon bar is updated to 
indicate the new speed by 


Figure 5. Mouse_5 


When the bar is left of centre the speed 
setting is slow (1 or 2) while to the right the 
speed is fast (4 or 5). 


Listing 1 

Set MouseS$Dir <Obey$Dir> 

If "<Mouse$Flag>" = "" then error !Mouse 
is already running 

Set Mouse$Flag 

WimpSlot -min 16k -max 16k 

Run <Mouse$Dir>. !RunImage 


Listing 2 
10 REM >!RunImage 
20 REM Program Mouse Speed Control 
30 REM Version Al.0 
40 REM Author Adam Goodfellow 
50 REM RISC User July/August 1990 
60 REM Program subject to copyright 
10:3 
80 ON ERROR OSCLI"Unset Mouse$Flag":E 
RROR EXT ERR, REPORTS+" at line "+STRSERL 
:END 
90 DIM wimp 255, menu 255, icons 511, 
sprites 2559, mouse 11 
100 oldsp=2:iconbar=-2 
110 SYS "OS Byte",161,194 TO ,,speed 
120 IF speed<1 speed=1 ELSE IF speed>5 
speed=5 
130 SYS "Wimp Initialise", 200, &4B53415 
4,"Mouse" TO task 
140 !sprites=2560 
150 SYS "OS SpriteOp", &10A, sprites, "<M 
ouse$Dir>.Sprites" 
160 :SYS "Wimp SpriteOp", 40,-1,"!mouse 
"TO ,,,W,h 
170 wimp! 0=-1:wimp! 4=0:wimp! 8=0 
180 wimp! 12=w*2:wimp!16=h*4 
190 $mouse="mouse_1":wimp!20=40700311A 
200 wimp!24=mouse:wimp! 28=sprites 
210 wimp!32=LEN ("mouse_1") 
220 SYS "Wimp CreateIcon",,wimp TO mic 
on: PROCmouse 
230 $menu="Mouse" :menu?12=7:menu?13=2 
240 menu?14=7 :menu?15=0:menu! 16=96 
250 menu! 20=44:menu!24=0:menu!28=0 
260 menu!32=-1:menu! 36=&07000011 
270 $(menu+40)="Save" :menu! 52=128 
280 menu! 56=-1:menu! 60=607000011 


the position of the dark blue vertical bar. = 
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290 $ (menu+64)="Quit" 500 WHEN 4:s=speed:speed=oldsp:oldsp=s 
300 end=FALSE :PROCmouse 
310 REPEAT 510 ENDCASE 
320 SYS "Wimp Poll",1,wimp TO reason 520 ENDIF 
330 CASE reason OF 530 ENDPROC 
340 WHEN 2:SYS"Wimp OpenWindow", , wimp 540 : 
350 WHEN 3:SYS"Wimp CloseWindow", , wimp 550 DEF PROCmenudone 
360 WHEN 6:PROCmousechange 560 SYS "Wimp GetPointerInfo",,wimp+4 
370 WHEN 9:PROCmenudone 570 CASE wimp!0 OF 
380 WHEN 17,18:IF wimp!16=0 end=TRUE 580 WHEN 0:SYS "OS Byte", 162,194, speed 
390 ENDCASE 590 WHEN 1:end=TRUE 
400 UNTIL end 600 ENDCASE 
410 *UnSet Mouse$Flag 610 IF wimp!12=1 SYS "Wimp CreateMenu" 
420 SYS"Wimp_CloseDown", task, &4B534154 » menu, wimp! 0-64, 44*4+52 
430 END 620 ENDPROC 
440 : 630 : 
450 DEF PROCmousechange 640 DEF PROCmouse 
460 IF wimp!12=iconbar 650 MOUSESTEP speed 
470 CASE wimp!8 OF 660 $mouse="mouse_"+STR$speed 
480 WHEN 1:speed=(speed MOD 5)+1:PROCm 670 !wimp=iconbar:wimp! 4=micon 
ouse 680 wimp!8=0:wimp!12=0 
490 WHEN 2:SYS "Wimp CreateMenu", ,menu 690 SYS "Wimp SetIconState",, wimp 
,wimp!0-64, 44*3+52 700 ENDPROC RU 


Archimedes memory upgrades 
A310 expanded to 2Mb - £375 A310 expanded to 4Mb - £595 


These fully guaranteed boards (CJE which are simply not available with only 
Micro’s) combine with the existing RAM —_1Mb. A305 computers can also be fitted 
in the machine to give a total of either with these memory boards, although they 
2 or 4Mb. The extra memory is must be upgraded to the full 1Mb first. 
functionally identical to that in a 400 Prices include VAT, fitting (3 day turn 
series machine, and offers facilities around) and carriage. 


* For the A305 and A310 AVAILABLE NOW 
* Compact, single-board design - no messy ribbon cable 
* 2Mb version can be upgraded to 4Mb later. ARM3 compatible 


* Price includes VAT, fitting and overnight courier collection/delivery of your machine 


Write or phone now for our free illustrated leaflet. 


A3000 extra IMb (2Mb total) £99 
RAM for 40/1 series POA, approx £80 perMb ~~ RAM for A3000... IFEL 


45Mb internal SCSI hard disc system (Oak) i 
4-slot multi-layer backplane + fan (305/310) Only £99 inc. VAT 36 Upland Drive 


Impression 2145 (user fittable) Derriford 
Prices inclusive of VAT Plymouth 
Write or phone for our free current price list (0752) 84286 GN PL6 6BD 
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Making the Most of SID 


Acorn’s Support Information Database contains much of interest to 
rchimedes users. Alan Wrigley has the details. 


A 
S ID is an on-line database available free 
of charge to the general public on its own 
dedicated telephone line, or through a 
gateway from Prestel for a small charge. 
Anyone who has a modem and appropriate 
comms software can access SID. 


As you might expect, all material on SID 
is exclusively for users of Acorn micros. All 
machines are covered, even the model B if 
there are items relevant to that computer. 
However, it is only natural that most material 
on SID is geared towards the Archimedes, 
and therefore RISC User readers will find 
much of interest and value to them. 


18-May-90 


18-May-90 
8-May-90 
18-May-90 
18-May-90 
6-Apr-90 
sa YP 


New BIG map of SID 18-May-90 
PC Emulator 1.34 and OR-DOS 


The Main Menu on SID 


The first time you log on to SID, you may 
find yourself confused by all the different 
areas available to browse through. To help 
you, a map of SID is provided which can be 
downloaded as a Draw file, and subsequently 
printed out as a permanent reference for use 
when accessing the database. SID is a 
viewdata system, based around hierarchical 
menu screens, but like Prestel it makes use 
of keywords, which are a lot faster to use 
once you know where you want to go, and 
this is where the map will help. 


SID PROFILE 


SID is organised into five main areas, 
namely News, The User Base, The Data 


Base, El Sid and Bulletin Boards. The news 
area is self-explanatory and contains news, 
not only about Acorn and its products, but 
information from third party suppliers as 
well as news affecting educational and 
healthcare users. The User Base contains 
various items such as dealer lists and 
adverts, directories, information about SID 
and its users, and closed user groups, for 
example for dealers and schools. El Sid is a 
collection of magazine areas, offering 
comment and opinion, features on micro- 
related topics such as education, comms and 
graphics, and software reviews. 


USEFUL INFORMATION 

The real meat of SID is in the remaining 
two areas. Within The Data Base you can 
find downloadable files of information, for 
example application notes, details on a 
number of products, and of course a very 
wide range of downloadable software. 
Software found on other, private, bulletin 
boards is often of questionable quality, not to 
mention potentially carrying the risk of virus 
infection - although our Watchdog utility 
from last month’s magazine will reduce the 
risk. However, all the software available on 
SID is of a high quality, and some of the 
items have been included on previous RISC 
User monthly discs, for example the window 
template editor FormEd, and the RISC OS 
Extras. The software ranges from complete 
Desktop applications to small utilities, and 
includes games, data files (e.g. sprites and 
Draw files) and demos, 


The bulletin board area is a lively focal 
point for the exchange of information and 
opinion. Boards are provided on a number of 
topics, such as RISC OS, software, 
hardware, general comments, printers, PC 
Emulator, image manipulation and 
communications. The boards are used for 
posting messages, either to ask for, or to 
provide, help or to offer an opinion on topics 
of current interest. You can read through the 
messages on any or all of the boards, or post 
your own message with ease. Each time you 
log on you can elect to read all messages 
which have been posted since you last 
accessed SID, making it very easy to keep up 
with all that has gone on in the meantime. 
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HOW TO ACCESS SID 

Assuming you have the necessary 
hardware and software, you can dial up SID 
straight away on (0223) 243642. The 
database is in viewdata format on the 
standard V23 protocol (1200/75 baud, 7 bits, 
even parity, 1 stop bit). If you are a 
subscriber to Prestel or Micronet, however, 
it is much simpler, and unless you live near 
Cambridge much cheaper, to access SID 
through the Prestel gateway provided by 
using the keyword *SID. 


found on SID 


Once you are on SID, you will find it 
useful to download the map and print it out. 
You can find this via an option at the foot of 
the main menu page. The map will show 
you the structure of the database as well as 
the keywords to use for each area. Using 
these will often avoid having to travel via 
several levels of menu, so they can cut down 
your on-line time considerably. You can then 
browse around the rest of SID. Do read 
some of the bulletin board messages, as they 
will give you an idea of the topics which are 
currently being debated in the Acorn world, 
and of course, if you have a specific problem 
you can post your own message to ask for 
help. Many expert users as well as Acorn 
staff use SID so it is very likely that 
someone will reply before too long. 


SOFTWARE 
It is also a good idea to have a look at the 
software available for downloading. You will 


almost certainly find something useful. Most 
of the files are archived, which means they 
have been compressed to take up less space 
(and save your telephone bill!). Needless to 
say, a program for de-archiving the files, 
called Sparkplug, can also be downloaded. 


EQUIPMENT 

In order to gain access to any on-line 
service, including SID, you will need a 
modem and communications software. There 
are a number of inexpensive modems on the 
market but you do have to be careful to get 
the correct lead for the Archimedes. The 
wiring may differ from one modem to 
another, so make sure you obtain a lead 
which is specifically designed for the set-up 
you are using. Comms packages for the Arc 
are not as abundant as for other machines, 
but there are some good ones, including 
BEEBUG’s own Hearsay. 


Software reviews In El Sid 


COSTS 

Currently the cost of accessing SID is the 
price of a phone call to Cambridge if you dial 
direct. From Prestel it costs 11p per minute 
between 08.00 and 18.00, and 4p per minute 
at other times, though these figures include 
the standard Prestel time charge. Micronet 
members pay 8p per minute from 08.00 to 
18.00, 2p per minute from 18.00 to 24.00, and 
1p per minute at other times, again including 
standard time charges. All in all, SID is well 
worth a look. If anything happens in the 
Acorn world, SID will know aboutit! yy 
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Archimedes Software 


Disc 7 - A New Chess Program for The Archimedes. 

At last, a Chess program that takes full advantage of RISC OS. Chess is now a 
true RISC OS application, installing itself on the icon bar and running on the 
desktop in a window at the same time as other applications. This means you 
can carry on working with other programs whilst the Chess program is thinking 
of its next move, 

Features: load and save games, edit board, step backwards and forwards 
through game, computer 'v' computer mode, play black or white, reverse board, 
save game setup. multiple levels, print game. Moves displayed in algebraic 
notation. Full mouse control over game, on screen clocks. Hint. Choice of piece 
when promoting pawn. New better design of board and pieces. Undo move. 

A good chess game that fits beautifully into RISC OS. 


Disc 22 - Novapaint 16 colour paint package. 

Extensive paint package with Fontmaster two tone font system. user defined 

brushes, airbrush, auto-shader, colour fills. define graduated palettes. effects 
(pixel average, area squash/stretch/distort/rotate. sphere wrap, cylinder wrap. 
Online help, manual, 14 demo pictures and 24 fonts. 


Disc 23 Desktop Applications 
Disc of RISC OS lapplications, 24 system fonts, sprites and Draw files. Includes 
!!Fastdesk, !Backpict, !FileHelp, !CopyOpts, !FontFix, !Pointer(1-3), !RomSprite, 


\Indicator, !Saver, !SectCopy, !SoundOff, !Timer, !FormatTxt, !Aquarium. 


Disc 24 - RISC OS Terminals 

!TaskData and !TaskANSI multitasking RISC OS desktop terminals/ 
comms. programs for Viewdata and ANSI/VT100/VT52. Suit Prestel, 
bulletin boards and mainframes. Auto Logon scripts. CET and X/Y 
MODEM (batch) file transfer. |RS423State. CET coder. !SparkPlug. 


Also available: 


Disc EMACS. Classic multi document editor with macro language. Includes full C source. 
Disc XLISP. Object oriented version of LISP with C source and progs. New 2.00 version. 
Disc C Toolkit. 20+progs for C programmers with sources. grep, awk, make, sed, more... 
Disc Kermit. Archimedes, BBC and MSDOS versions of file transfer/comms. prog. 

Disc CrossStar. Wimp based crossword solver with huge dictionary. 

Disc 10 More C Tools, yace and lex with examples and C source. New versions... 

Disc 11 Little SmallTalk. Original object oriented language with C source, docs, programs. 
Disc 14 GNU Tools#1. Quality tools with source. grep, egrep, sed, awk, diff. New versions. 
Disc 15 Clip Art#1 50 black and white pictures, also 65 Epson LQ printer fonts, !Sparkplug 
Disc 16 Spark. RISC OS file and directory archiver. !backdrop, pd. !apps. 1Mb colour pics. 
Disc 18 MTV Raytracer. database driven 3D raytracing package with C source code. 

Disc 19 Starchart. RISC OS program to make Draw file starmaps. Catalog of 9000 stars. 
Disc 25 Vi Clones Two copies of the popular UNIX ‘vi' editor with C sources and docs. 


Each disc is £5.99 inc. Buy four claim another one free! 
David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. Full list available on request. 


Wimp Applications Made Easy 


If you are seeking a packaged approach to the writing of Wimp 
applications, then Mike lronmonger’s EasyWimp system may appeal. 


ou may have been following Lee 
Calcraft’s detailed exposition on 
Mastering the Wimp, and the writing of 
Wimp applications, but even so the wealth 
of detail which has to be mastered can 
still be quite daunting. The approach here 
is to provide a ready-made Wimp 
application shell (called EasyWimp), for 
those applications which require just a 
single window to function. The user then 
needs to add just two procedures in order 
to create a complete Wimp application. 
However, the series of articles referred to 
above will provide an _ excellent 


background to the discussion here. 


Screen display of the serial port application 

The first procedure required will 
contain a series of simple calls to create 
the window and the various icons and icon 
groups to be displayed inside the window. 
EasyWimp then automatically handles all 
clicks and key presses over the icons. 
When any change occurs in them, it calls 
the second additional procedure to inform 
it of the new state of the icon/group. This 
is termed an event, and the user’s code (in 
the second procedure) simply needs to 
respond to the new state of the icon/group 
with which the event is concerned. 


The best approach to understanding 
this system is probably to type in the 


program listed here which consists of 
EasyWimp plus the additional procedures 
to form a complete Wimp application, in 
this case to monitor and change the serial 
port status (see also Volume 3 Issue 4). 


As with any application, you need to 
start by creating an application directory, 
complete with a sprite file and a !Run 
Obey file. The easiest way to do this is to 
use the application shell generator 
published in RISC User Volume 3 Issue 2, 
assuming a default Wimp slot 
requirement of 32K. The user’s code can 
then be added to the end of EasyWimp, 
which should then be saved in the 
application directory as /RunImage. In the 
case of the listing here, the entire program 
should be saved as !RunImage without 
further ado. 


If you double click on the application’s 
icon in a directory viewer it will install 
itself on the icon bar. Clicking with Select 
on its icon there will open its window on 
the screen. You can then experiment with 
changing the various options as a basis for 
the discussion which follows, and with a 
view to creating your own Wimp 
application. 


The first of the two additional 
procedures (from line 2230 onwards) must 
be called PROCset_up, and this in turn 
will need to make calls to other 
procedures already existing in EasyWimp, 
the first of which should be to 
PROCcreate_window: 


DEF PROCcreate_window (title$, W%) 


This creates the titled window with a 
width of W% half characters (all X co- 
ordinates and icon widths supplied to the 
procedures are specified in units of half a 
character) - see line 2240. 


Next come the calls to create the icons. 
These should be added in the order in 
which the icons are to appear in the 
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window, from top left to bottom right. 
Most of them are functions which return a 
unique group number so that when an 
event occurs the user knows which group 
the event is concerned with. As well as 
this, there are some parameters which 
must be specified which are common to 
several of the calls: 


X% the x co-ordinate of the icon. 
Y% the y co-ordinate of the icon in 
units of a character. 


Both of these assume an origin at the 
top left-hand corner of the window. 


text$ the text that appears in the icon. 

title$ if not null, this title appears to 
the left of the icon/group. 

opt$ _a list of options separated by a 


comma and ending with a 
comma. 

width% the width of the icon. 

tab% the spacing between a set of 
icons. 


The calls themselves are as follows: 


DEF PROCtext(x%,y%,text$) - This 
creates a simple text icon with no border 
or background. Clicks on this text are 
ignored and no event is generated. 


DEF FNonoff(X%,Y%,text$,on%) - 
This creates a text and sprite icon with 
the Desktop’s opt-on or opt-off icon on the 
left and the text on the right. The 
parameter on% (TRUE or FALSE) 
determines which sprite is displayed 
initially, and clicking on any part of the 
icon reverses the state and generates an 
event. See line 2400 in the example. 


DEF FNinput(X%,Y%,title$,init$, 
len%,width%) - This creates a writeable 
icon which accepts up to len% characters, 
and initially contains the string init$. A 
click on this icon causes the red caret to 
appear in the icon, and the text can then 
be edited. While editing, there are three 
keys which have special effects. Cursor-up 
and cursor-down will move the caret into 
the previous or next writeable icon 
without generating an event, while 
pressing Return generates an event which 


returns the string entered and then moves 
the caret to the next writeable icon. 


DEF FNaction(X%,Y%,opt$,width%, 
tab%) - This creates a group of icons of 
the menu type. When the pointer is over 
one of these icons, the icon is inverted, 
and clicking on the icon will generate an 
event. 


DEF FNradio(X%,Y%,title$,opt$, 
on%,tab%,indent%) - This creates a 
titled group of text and sprite icons with 
the Desktop’s radio-on or radio-off sprites. 
The string opt$ specifies the options, and 
if they go off the right-hand edge of the 
window they move down a line and start 
at an X co-ordinate of indent%. With radio 
buttons, only one of these icons will be on 
at any time, and initially that selected is 
specified by the value of on%. When the 
user clicks on one of the icons, it is 
selected and an event is generated. See 
lines 2340, 2370 and 2430. 


DEF FNchoice(X%,Y%,title$,opt$, 
width%,on%) - This creates a group of 
three icons which allow the user to select 
any one of the options specified in opt$. 
Following the title is a left arrow, and 
then the current choice (initially on%), 
and a right arrow. When the user clicks on 
one of the arrow icons, the next choice in 
the list is displayed in the central icon, 
which then generates an event. See lines 
2280 and 2300. 


The second procedure, to which the 
user should add his own code, must be 
called PROCevent. The parameters passed 
to this by the built-in Wimp_Poll routine 
specify the icon/group with which the 
event is concerned and the new state of 
that icon/group as follows: 


DEF PROCevent(group%,b1%,b2%, 
on%,string$) 


group% - This is the group number of 
the icon/group concerned. 


b1% - For radio and action groups this 
is the number of the icon in the group. For 
example, in a radio group of five options 
the first icon will be number zero and the 
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last number four. In choice icons 61% 
specifies the current choice, the first 


choice being numbered zero. 


2% - This is only used in choice icons, 
where it specifies the total number of 


choices available. 


on% - This specifies whether the icon 
is selected (on) or not (off). It’s only of 


relevance to on-off icons. 


string$ - This is the string which the 
icon contains. For input icons this string 
will have been entered by the user, and for 
choice icons this will be the current choice. 
The easiest way to decode these 
parameters is with a CASE structure 
using group%. The WHEN statements of 
this should.pick out the group with which 
the event is concerned, and call the 
relevant routine, user-written procedure 
or function, or an appropriate SYS call 
with any of the other parameters that the 
routine requires. See lines 2480 to 2530 in 
the example application. Note that this 
also includes references to an additional 


user-written procedure, PROCnew. 


All the above may sound a little 
complicated, but as always it’s much 
simpler to use than it is to describe. An 
inspection of the extra code of the example 
application should help clear up any 


points on which you're not sure. 


We would be interested to receive any 
applications which readers might write 
based on Mike Ironmonger’s EasyWimp 


with a view to publication in the magazine 
or on the magazine disc, 


10 REM >$.!Serial. !RunImage 
20 REM Program Serial port control 


30 REM Version A 1.00 
40 REM Author Mike Ironmonger 
50 REM RISC User July/August 1990 


60 REM Program Subject To Copyright 


10: 


80 ON ERROR VDU4:PRINTREPORT$;" at li 


ne ";ERL;", quitting.":END 
90 PROCinitialise 


100 ON ERROR PROCerror (ERR, REPORTS) 


110: 
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120 REPEAT 

130 SYS "Wimp Poll", &81833,block% TO R 
& 

140 CASE R% OF 

150 WHEN 2 : SYS "Wimp OpenWindow", ,b 
lock’ 

160 WHEN 3 : SYS "Wimp CloseWindow",, 
block’ 

170 WHEN 6 : PROCbutton_click(block’! 
8, block%!12, block%!16) 

180 WHEN 8 : PROCkey press (block%!4,b 
lock$!24) 

190 WHEN 9 : quitt=(!block%=0) 

200 WHEN 17,18 : quit%=(block%!16=0) 

210 ENDCASE 

220 UNTIL quit’ 

230 SYS "Wimp _CloseDown" 

240 END 

250 : 

260 DEF PROCbutton_click (B%,W%, 1%) 

270 CASE Bt OF 

280 WHEN 1,4 : IF W%=-2 PROCopen_wind 
ow ELSE PROCicon_click (B%, 1%) 

290 WHEN 2 : IF We=-2 SYS "Wimp Creat 
eMenu", ,menu%, !block$-64, 140 

300 ENDCASE 

310 ENDPROC 

320: 
330 DEF PROCicon_click (B%, 1%) 
340 PROCget_info (1%) 
350 CASE type% OF 
360 WHEN 1.: PROCnew_choice(b1%-1) 
370 ENDCASE 
380 PROCevent (group%,b1%,b2%, on%, text$ 


390 ENDPROC 
400 : 

410 DEF PROCnew_choice (inc%) 

420 1%-=inc%:PROCget_info(I%) 

430 b1%=(b1%+inc%+b2%) MODb2% 

440 code% (1%) = (b2%<<16) + (b1%<<8) +group 


450 text$=FNget (choice$ (group$) ,b1%) 

460 Sblock%!28=text$:PROCset_icon_stat 
e(w_main%, 1%, 0,0) 

470 ENDPROC 

480 : 

490 DEF PROCget_info (1%) 

500 code%=code% (I%) 

510 groupt=code%AND255 

520 b1%=(code%>>8) AND255 

530 b2%=(code%>>16) AND255 
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540 type%=code%>>24 

550 !block%=w_main’:block$!4=I% 

560 SYS "Wimp GetIconState", , block’ 

570 ont=-( (block%!24>>21) AND1) 

580 text$=FNstring (block%!28) 

590 ENDPROC 

600 : 

610 DEF PROCkey press (1%,C%) 

620 CASE C% OF 

630 WHEN 13 : PROCicon_click(-1,1%):P 
ROCmove_caret (1%, 1) 

640 WHEN &18E : PROCmove_caret (1%,1) 

650 WHEN &18F : PROCmove_caret (1%,-1) 

660 OTHERWISE SYS "Wimp ProcessKey",C 


670 ENDCASE 

680 ENDPROC 

690 : 

100 DEF PROCmove_caret (1%, dir%) 

710 REPEAT 

720 I%=(I%+dir%+icons%)MODicons% 

730 UNTIL code% (I%)<0 

740 PROCcaret_to (1%) 

750 ENDPROC 

760 : 

770 DEF FNstring (P%) 

780 Age" 

790 WHILE ?P$>31 

800 AS+=CHR$?P%:PSt+=1 

810 ENDWHILE 

820 =AS 

830 : 

840 DEF PROCset_icon_state(!block%,blo 
ck%!4, block$!8,block%!12) 

850 SYS "Wimp SetIconState", , block’ 

860 ENDPROC 

870: 

880 DEF PROCcaret_to(I%} 

890 SYS "Wimp SetCaretPosition",w_main 
%,1%,9999,,-1,-1 

900 ENDPROC 

910 : 

920 DEF PROCerror (!block%, $ (block%+4) ) 

930 SYS "Wimp ReportError", block%, 1, ap 
p$ 

940 ENDPROC 

950 : 
960 DEF PROCinitialise 
970 DIM block’ 255,menu% 99 
980 : 
990 SYS "OS ReadVarVal", “Obey$Dir",blo 
ck%,256 TO ,, lent 


1000 P$=block%+len%-1:app$="" 

1010 REPEAT 

1020 app$=CHR$?P%+app$ :P$-=1 

1030 UNTIL ?P%=ASC"!" 

1040 : 

1050 SYS "Wimp Initialise", 200, &4B53415 
4, app$ 

1060 Mt=menu% : $M%=app$ 

1070 M$!12=&70207 :M%!16=100:M%!20=44 
1080 M3!24=0:M%!28=&80:M%!32=0 

1090 M3!36=&7000029:$ (M3+40)="Quit" 
1100 Bt=block$: !B%=-1:B%!4=0:B%!8=0 
1110 B¢!12=68:B%!16=68:B%!20=6301A 
1120 $(B%+24)="!"+app$ 

1130 SYS "XWimp_SpriteOp",24,,B%+24 TO 
7B 

1140 IF ESAND1 $(B%+24)="Application" 
1150 SYS "Wimp CreateIcon", ,B% 

1160 : 

1170 quit%=FALSE 

1180 group%=0:ESG%=1 :miny%=0 

1190 larrow$=CHR$136;rarrow$=CHR$137 
1200 : 

1210 DIM b_onoff% 13:$b_onoff%="soptoff 
,opton" 

1220 DIM b_radio% 17:$b_radio%="sradioo 
ff, radioon" 

1230 DIM choice$ (255) , code% (999) 

1240 PROCset_up 

1250 : 

1260 B%=block$: !B%=0:B%! 4=miny%-8 

1270 BS! 8=width%*8+4 :B%!12=0 

1280 SYS "Wimp SetExtent",w_main’, BS 
1290 ENDPROC 

1300 : 

1310 DEF PROCtext (x%,y%, text$) 

1320 IF text$="" ENDPROC 

1330 PROCicon (-1, LEN (text$), text$,x%,y% 
, LEN (text$) *2, 44, 7000109, 0, 0,0) 

1340 X%=x$+LEN (text$) *2+1 

1350 ENDPROC 

1360 : 

1370 DEF FNonoff (x%, Y%, text$,on%) 

1380 PROCopt_icon (X%,¥%,b_onoff%, text$, 
-(on%<<21) ,0) 

1390 group$t=1:=group%-1 

1400 : 

1410 DEF FNinput (X%, Y%, title$, init$, len 
%, widths) 

1420 PROCtext (X%, Yt, title$) 

1430 PROCicon (-1, len, init$,X%,Y%, width 
%, 48, &700F12D, 128, 0,0) 
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1440 group%+=1:=group%-1 
1450 : 


1460 DEF FNaction (X%, Y%, opt$, width’, tab 


8) 
1470 N%=0:A$=FNget (opt$,N%) 
1480 REPEAT 


1490 PROCicon (-1, LEN (A$) ,A$,X%,Y%,widt 


h&, 48, &C700912D+ (ESG%<<16) ,0,0,N%) 
1500 N%+=1:X%+=tab% 
1510 A$=FNget (opt$,N%) 
1520 UNTIL A$="" 
1530 ESG%+=1:group%t+=1:=group%-1 
1540 : 


1550 DEF FNradio(X%, Y¥%,title$, opt$,on% 


tab%, indent$) 
1560 PROCtext (xX%, Y%,title$) :N%=0 
1570 REPEAT 


1580 A$=FNget (opt$,N%) : L$=LEN (A$) *2+7 


1590 We=tab$:IF W%<L% W%=L% 


1600 IF X%+W%>widthS X%=indent$:Y%$t=1 
1610 IF A$<>"" PROCopt_icon(X%,¥%,b_ra 
dio’, A$, (ESG%<<16) - ( (NS=on$) <<21) ,N%) 


1620 X$t+=WS:NSt=1 

1630 UNTIL A$="" 

1640 ESG%+=1:group%t=1:=group$-1 
1650 : 


1660 DEF FNchoice(Xx%, Y%, title$, opt$,wid 


th%,on%) 
1670 choice$ (group%)=opt$ 
1680 tot%=-1:len%=0:P%=1 
1690 REPEAT 
1700 F%=INSTR(opt$,",",P%) 
1710 IF F%-P%$>len% lent=F%-P% 
1720 totS+=1:P%=F%+1 
1730 UNTIL F%=0 
1740 PROCtext (X%, Y%, title$) 


1750 PROCicon (-1,1,larrow$,X%, Y%,4,48,& 


700312D,1,0,0) 


1760 PROCicon (-1, len’, FNget (opt$,on%) ,X 
$+5,Y%, width’, 48,&700012D, 0, tot%, on’) 
1770 PROCicon (-1,1, rarrow$,X%+6+width%, 


Y%, 4,48, &700312D,1, 0,2) 
1780 group%+=1:=group$-1 
1790 : 


1800 DEF PROCopt_icon (X%, ¥%,ind%,A$, fla 


g%, num) 


1810 PROCicon (ind%, LEN (A$) ,A$,X%,Y%, LEN 
(A$) *2+6, 44, 61700B113+£1ag%, 0, 0, num’) 


1820 ENDPROC 

1830 : 

1840 DEF FNget (A$,N%) 
1850 FORA%=0TONS 
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1860 L%=INSTR(A$,",") 

1870 BS=LEFTS$ (A$,L%-1) 

1880 AS$=MID$(A$,L%+1) 

1890 NEXT 

1900 =B$ 

1910 : 

1920 DEF PROCcreate_window (title$, W%) 

1930 width%=W%:lenS=LEN (title$) 

1940 B%=block$ : $B%=STRINGS (88, CHRSO) 

1950 !B%=640-W%*4:B%!8=9999:B%!12=884 

1960 B%!28=&87000012:B%!32=&1000207 

1970 B$!36=&C0103:B%!56=&119:B%!64=1 

1980 DIM buf% len%:$buf%=titles 

1990 B$!72=buf%:B%!76=-1:B$!80=len$+1 

2000 SYS "Wimp CreateWindow",,B% TO wm 
aint 

2010 ENDPROC 

2020 : 

2030 DEF PROCopen_window 

2040 !blockt=w_main’ 

2050 SYS "Wimp _GetWindowState", , block$ 

2060 block%!28=-1 

2070 SYS "Wimp _OpenWindow", , block’ 

2080 ENDPROC 

2090 : 

2100 DEF PROCicon (ind%, len%,text$,X,Y,W 
7H, flag’, type%, b2%, b1%) 

2110 Be=block$:!B%=w_main’ 

2120 B&!4=X*8:BS!12=B%! 4+W*8+4 

2130 BS !8=-Y*56-56:B%!16=B% ! 8+H 

2140 BS!20=flag’ 

2150 DIM buf% len%:$buf%=text$ 

2160 BS!24=buf%:B%!28=ind% :B%! 32=len$+1 

2170 SYS "Wimp _CreateIcon", ,B% TO 1% 

2180 icons%=I%+1 

2190 code% (1%) =(type%<<24) + (b2%<<16) + (b 
1%<<8) tgroup% 

2200 IF B%!8<miny% miny%=B3!8 

2210 ENDPROC 

2220 : 

2230 DEF PROCset_up 

2240 PROCcreate _window("Serial port sta 
tus:",104) 

2250 : 

2260 AS="9600,75, 150,300, 1200, 2400, 4800 
+9600, 19200, 50,110, 134"+CHRS$189+", 600,18 
00, 3600, 7200" 

2270 SYS "OS _Serialop",6,-1 TO ,t_rate% 

2280 g_transmit%=FNchoice (1,0, "Transmis 
sion baud rate:",A$,12,t_rate% 

2290 SYS "OS SerialOp",5,-1 TO ,r_rate% 

2300 g_receive%=FNchoice (11,1, "Receive 
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baud rate:",A$,12,r_rate%) 

2310 : 

2320 SYS "OS Serialop",1,-1 TO ,data_fo 
xmat% 

2330 B%=3-data_format %AND3 

2340 g_word_length%=FNradio (3,2, "Word L 
ength:","5 bits,6 bits,7 bits,8 bits,",B 
%,0,0) 

2350 : 

2360 B%=(data_format%>>2) AND1 

2310 g_stop_bits%=FNradio(7,3,"Stop bit 
s:","one, two, ",B%,14,0) 

2380 : 

2390 B%=(data_format%>>3) AND1 

2400 g_parity ont=FNonoff(1,4,"Parity o 
n:",B%=1) 

2410 : 

2420 B%=(data_format%>>4) AND3 

2430 g_parity numt=FNradio(28,4,"","odd 
,even, always 1 on TX - ignored on RX,alw 
ays 0 on TX - ignored on RX,",B%,14, 28) 
2440 ENDPROC 

2450 : 


2460 DEF PROCevent (group%, b1%,b2%, on%,t 
ext$) 

2470 CASE group% OF 
2480 WHEN g transmit’ 
Op", 6,b1% 

2490 WHEN g receivet : 
p",5,b1% 

2500 WHEN g word length’ 
mat ($11, 3-b1%) 

2510 WHEN g_stop bits’ 
t (8100,b1%<<2) 

2520 WHEN g parity on% 
t ($1000, (-on%) <<3) 

2530 WHEN g parity numé 
at (3110000, b18<<4) 

2540 ENDCASE 

2550 ENDPROC 

2560 : 

2570 DEF PROCnew_format (bic%, eor’) 

2580 data_format%=(data_format $AND (NOTb 
ic%))EOReor’$ 

2590 SYS "OS Serialop",1,data_format’ 
2600 ENDPROC RU 


: SYS "OS Serial 

SYS "OS Serialo 
: PROCnew_for 
: PROCnew_forma 
: PROCnew_forma 


: PROCnew_form 


Base 
5 


BaseS’ DBMS is a unique kind of database management system specifically 
developed for the Archimedes. Unique, because it offers a complete database 
language and library, able to work from within your Basic programs. No 
“Tricksy” code has been used so all Base5 programs are fully compatible with 
Basic compilers. The comprehensive documentation contains an extensive 
tutorial as well as a language reference. A number of databases and programs are 
also supplied as example material. 

More modules are being developed all the time and will be available to registered 
users at preferential prices. Registered users will also enjoy ONE YEARS FREE 


technical support! 
Base5 
£69 P O Box 378 
WOKING 


Inclusive of VAT, Postage & Packing Surrey GU21 4DF 
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DTP Resources 


Alan Wrigley looks at some recent software releases which provide 
fonts or artwork for use with a DTP package. 


T he proliferation of DTP packages for the 
Arc, together with a growing realisation 
that the computer is a powerful contender 
when it comes to choosing a system for DTP 
work, has encouraged the spread of software 
releases aiming to provide resources for this 
purpose. In this review, I shall be looking at 
a number of collections of clip art, a range of 
outline fonts which supplement those 
already available from Acorn, and a utility 
which enables you to manipulate outline 
font text in a way not possible with the 
standard tools. 


MAPS OF THE WORLD 

World Geography Maps (£29.95), from 
Micro Studio, is a two-disc set of Draw files 
containing outline maps of about 150 
countries. Each map shows an outline of the 
country in black, with the capital city in red 
and other major cities in black. Large areas 
of water are shown in blue. Some larger 
countries, e.g. Australia and the USA, also 
have state boundaries marked. This appears 
to be a competent package, and should form 
a very useful library of basic images for 
anyone involved with geographical subjects. 


DTP_IMAGES 

G.A.Herdman Educational Software has 
released seven discs packed with files of 
artwork, under the generic name of 
DTP_Images (£8.99 per disc, or £7.49 if 
more than one ordered at a time). Disc 1 
contains a mixture of Draw and sprite files 
as well as digitised images, covering 
subjects such as road signs, maps, frame 
shapes etc. Disc 2 has sprite files of people, 
animals, maps, places and so on, plus Draw 
files on the subject of celebration. Disc 3 
contains around 130 Draw files on scientific 
themes, for example electronic components, 
laboratory equipment and glassware, and 
scientific and OS map symbols. Dise 4 is 
primarily composed of heraldry images in 
Draw format, plus an excellent detailed 
picture of the Mallard locomotive. The main 
theme of Disc 5 is food, while on disc 6 you 
will find digitised sprites on a natural 


history theme. Finally disc 7 contains Draw 
and Sprite files on trees. 


Some of the pictures on these discs I felt 
were rather simple and could just as easily 
be drawn in a couple of minutes by the user. 
Some others could perhaps benefit from 
more detail. But there are many worthwhile 
images on each disc, and. taken as a whole, 
the set provides an inexpensive library of 
useful pictures which will cover a great 
many requirements. 


MIDNIGHT GRAPHICS 

A new collection of clip art has recently 
been released by Midnight Graphics. Draw 
Format Clip Art (£34.44) is a five-disc set, 
each one containing a full 800K of Draw 
files. The subject range covered is enormous, 
including animals, computer and office 
equipment, transport, food, maps, 
telephones, credit cards and people engaged 
in a wide range of activities, plus lots more. 
There are also useful items which can be 
dropped into a document, such as borders, 
arrows, shapes etc. 


"Teens" from Midnight Graphics' clip art 
collection 


Some images are monochrome and some 
colour, and most have been drawn to a very 
high standard. Some are straightforward 
pictures, some are stylised graphic images, 
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and a few introduce cartoon-style humour. 
Many of the drawings are highly 
imaginative. Certain images I felt lacked a 
degree of accuracy, and had not been drawn 
to the same degree of realism as some of the 
pictures on the Computer Concepts disc 
(mentioned below). However, there are so 
many useful items in this set that it 
represents excellent value, and must 
contain something of use for everyone. 


In addition to the material covered here, 
at least two of the DTP packages have clip 
art bundled with them. Computer Concepts’ 
Impression has a disc of Draw and Sprite 
files containing detailed, high quality 
images, and BEEBUG’s Ovation also has a 
disc of artwork. Unlike other artwork 
packages, this is supplied as a set of pages 
of images, each on a related theme, any of 
which can be imported directly onto the 
clipboard for incorporation into a document. 


FONTS 

Just as independent companies are 
finding it worthwhile to produce discs of 
artwork, so the same thing is beginning to 
happen with fonts. Electronic Font Foundry 
has had a range of fonts available for a little 
while now, and is 
currently 
extending the 
range. The price 
for a single font 
is £10.92, but 
there is a range 
of discounts on 
larger quantities. 
For example, 2 or 
3 fonts from the 
same family will 
cost £9.14 each, a 
complete font disc (which may contain 17 to 
21 fonts) costs from £98.61 to £114.88 
depending on which disc you buy, and a 
complete set of 112 fonts costs £513.91. 


The range includes some fancy fonts as 
well as the more conventional ones you 
would expect to find. They are claimed to be 
compatible with Acorn’s outline fonts, and in 
fact the review samples I looked at appeared 
to work faultlessly with both Ovation and 
Impression. They will not, however, load 


into Acorn’s FontEd, though I suspect that 
this is by design, to prevent tampering with 
them, rather than any incompatibility. 


There are a few things to consider when 
purchasing fonts. Firstly, are they hinted 
and scaffolded? If not, you may have 
problems displaying and printing them 
correctly at certain sizes. Secondly, are they 
PostScript compatible? You may not have a 
PostScript printer at present, but it would 
not be much use preparing documents using 
non-PostScript fonts which might at some 
time in the future be printed on one. 


The fonts supplied for review were 
Sophie, Oxford and Warsaw, all of which 
have PostScript equivalents, and a novel 
font called Fancy Dress, which is illustrated 
in this article. The total range supplied by 
EFF covers a wide variety of styles, 
including versions of all the most widely 
used fonts. The fonts appear to be hinted 
and scaffolded, although at some sizes I 
could detect discrepancies in the heights of 
some characters on the screen, though 
when printed on a laser printer at various 
resolutions everything seemed to be correct, 
However, the character widths are not quite 


BEPBUS Fait Dress Party 


EFF's Fancy Dress font, sloped using FontFx 


PostScript compatible, which means that if 
you are printing on a PostScript printer, 
you may find that the text does not occupy 


the same space as on screen. EFF is 


apparently negotiating with Adobe Systems 
and hopes to be able to announce 100% 
PostScript compatibility soon, so it is to be 
hoped that some attention will be given to 
this point. 


In addition to the EFF fonts reviewed 
here, there are of course Acorn’s own fonts 
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which are supplied with the Acorn Desktop 
Publisher, and BEEBUG also has a range of 
fonts available. 


FONT EFFECTS 

FontFx (£9.95) is a utility produced by 
Data Store Software. It allows you to input 
a line of text in any outline font installed in 
the machine, which it then outputs as a 
Draw file. However, this is-not all it does. 
The text can be scaled, rotated, sloped at a 
specified angle, arranged in a circle, arc or 
column; a shadow can be added, either 
behind or below, the outline thickness can 
be altered and different colours chosen. All 
of this is very easy to achieve using a series 
of dialogue boxes within the main window. 
When all the effects have been chosen and 
the file created, the image can be further 
manipulated in Draw before being imported 
into a DTP package. 


Image produced by manipulating text with 
FontFx 


FontFx also has a command language, 
which enables you to prepare script files 
using Edit for processing by FontFx. This 
file will contain FontFx commands as well 
as text to be treated, and can be dragged 
into FontFx to be processed. 


FontFx is a most useful utility, but you 
cannot see the effect you are creating on the 
screen. To do this you must save the file and 
then load it into Draw. This can be a 
nuisance on a 1 Mbyte machine, but it is 


worth the trouble as you can do things with © 


text that are simply not possible using Draw 
alone - text in Draw can only be handled 
horizontally. 


The version I reviewed (3.20) had a 
couple of faults, but Data Store do regularly 
update the software as soon as any 
problems are discovered. In fact, the most 
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serious bug I encountered was sorted out on 
the telephone in a couple of minutes, and 
was immediately incorporated into the 
latest version there and then. 


New products in this field are coming 
out all the time, and there is a much wider 
range than has been covered here. In 
addition to those products produced 
specifically for the Archimedes market, a 
large quantity of clip art packages has been 
available for PCs and other computers for 
some while. Some of this material can be 
used on the Arc, provided that it is in the 
correct format. Acorn’s very useful utility 
ChangeFSI (included on the RISC User 
Volume 2 Issue 10 monthly disc) will covert 
several formats to sprite files, and some 
DXF files can be directly imported into 
Draw. 


Product 
Supplier 


World Geography Maps 
Micro Studio 

22 Churchgate Street 
Soham, Ely 
Cambridgeshire CB7 5DS 
Tel. (0353) 720433 


Product 
Supplier 


DTP_Images (discs 1-7) 
G.A.Herdman Educational Software 
43 Saint Johns Drive 

Clarborough, Retford 

DN22 9NN 

Tel. (0777) 700918 


Product 
Suppller 


Draw Format Clip Art 
Midnight Graphics 

5 Victoria Lane, Whitefleld 
Manchester M25 6AL 

Tel. 061-766 8423 


Product 
Supplier 


Outline Fonts 

The Electronic Font Foundry 
Bridge House 

18 Brockenhurst Road 
Ascot SL5 9DL 

Tel. (0990) 28698 


EFF fonts are also available from: 
Jan Copestake Software 
10 Frost Drive, Wirral 
Merseyside L61 4XL 
Tel. 051-648 6287 


Product — FontFx 
Supplier Data Store Software 
6 Chatterton Road, Bromley 
Kent BR2 9QN 
Tel, 081-460 8991 RU 
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Assembler Workshop 


Writing applications 


David Spencer explains how to write applications in ARM code. 


) ——_— running under RISC OS 
(excluding interrupt handlers and other low- 
level nasties) can be divided into two broad 
types - those that are applications, and those 
that are not. For the purpose of this article 
we shall refer to non-applications as utilities, 
because many of them perform utility type 
operations. In this article we shall look at 
writing applications in ARM code, both as 
stand-alone programs, and as relocatable 
modules. In next month's Assembler 
Workshop we will look at the special 
problems involved in implementing multi- 
tasking Desktop applications as modules. 


Before delving into details, we need to be 
clear about what exactly is an application, 
and what is a utility. Intuitively, it is clear 
that a DTP package or spreadsheet is an 
application, while a disc formatter, for 
example, isn't. However, actually defining 
an application is not so straightforward. 
One view is that an application is the main 
task in control of the computer, while 
utilities are secondary tasks that can be 
called by the application. This view ties in 
with the way in which RISC OS views 
applications and utilities. To the operating 
system, utilities, whether they be module 
star commands or disc-based transient 
utilities, are subroutines that are called 
when needed, and exit using an instruction 
along the lines of MOV PC,R14. 


Applications on the other hand are very 
different. Once an application has been 
started by RISC OS it is very much on its 
own and free to do what it wants. An 
application is not allowed to return to RISC 
OS in the same way as a utility. Instead, a 
call to SWI "OS_Exit" must be made, which 
calls a piece of code known as the exit 
handler. We will come back to this in detail 
later, but for the time being it is sufficient to 
know that the default action when an 
application exits is to return to the 
supervisor star prompt if outside the 
Desktop, or simply kill the application if in 
a multi-tasking environment. Applications 
must generate errors directly by calling SWI 
"OS_GenerateError", and must also handle 


errors returned by any utilities they call. - 
Again, we will look at this in detail later. 


APPLICATION WORKSPACE 


As we have already mentioned, there are 
two main types of application - those 
implemented as stand-alone programs and 
those that are in the form of a relocatable 
module. In both cases, the application has 
available all the RAM that hasn't been 
claimed by the screen, RMA, operating 
system workspace etc. This RAM is mapped 
to start at address &8000 and the end 
address will depend on how much RAM is 
free. In addition, a module application can 
claim workspace in the RMA just like any 
other module. Outside of the Desktop, only 
one application can be active at a time, and 
hence all of the application memory is 
available to it. In the multi-tasking 
Desktop, the situation is different as all the 
applications must compete for the available 
memory. In this case, the task controller 
which forms part of the Wimp maintains a 
heap of free memory. When an application is 
started it is allocated the memory it needs 
from this heap. Any application can 
subsequently claim more memory, or return 
unused memory to the heap. However, even 
with this arrangement, the memory is 
remapped as needed to ensure that each 
application's workspace still starts at 
address &8000. 


THE APPLICATION 
ENVIRONMENT AND HANDLERS 
Each application runs in a particular 
environment, which defines factors such as 
the amount of available memory, and the 
action taken when the application quits. 
Whenever an application is started, its 
environment is set up by the caller. In a 
multi-tasking situation, each application 
has its own environment, and the Wimp 
switches automatically between them. 


A major part of an application's 
environment is a set of routines called 
handlers. These are routines which are 
called when exceptional events occur, such 
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as an address exception, the Escape key 
being pressed, or the program quitting. Full 
details of handlers can be found in the 
Program Environment chapter of the PRM. 
However, for now, the only handlers we need 
to consider are the error handler, which is 
called when an error occurs, the escape 
handler which is called when the Escape 
key is pressed, and the exit handler, which 
is called when SWI "OS_Exit” is executed. 


These handlers are set up using the call 
SWI "OS_ChangeEnvironment". Register RO 
should contain the handler number, which is 
6 for the error handler, 9 for the escape 
handler and 11 for the exit handler, and R1 
should contain the address of the routine. 
R2 can optionally contain a workspace 
pointer that is passed to the handler routine 
when it is called, and for the error handler 
R3 must point to a buffer in which to store 
the error message. For full details, see the 
documentation of this call in the PRM. 


STARTING APPLICATIONS 

The most common way of starting an 
application is by running a file that has 
filetype &FF8 (Absolute). RISC OS will 
automatically load such a file at address 
&8000 and start it executing as an 
application. 


A second way to start an application is 
to run a file that has the old style load and 
execution addresses, rather than a filetype. 
In this case, instead of loading the 
application at &8000, it is loaded at the load 
address specified with the file, and 
execution is started at the execution 
address. Another way to start an application 
is to use the command *GO which will run 
an application already in memory. If no 
argument is given then the execution starts 
at &8000, whereas an optional address can 
be given to force execution from a particular 
point. Incidentally, it follows from what was 
said earlier that none of these calls ever 
return as the application takes over. 


When an application is entered, it 
cannot rely on any of the processor registers 
being set to useful values. In particular, the 
stack pointer (R13) does not point to a 
suitable area of stack memory. It is up to the 
application to select an area of memory and 
set up a stack. It is conventional to start the 


stack at the very top of the application 
workspace and have it grow downwards, 
although this is not mandatory. The ARM 
processor is at this point in user mode (see 
the Assembler Workshop in RISC User 
Volume 3 Issue 4), and therefore the stack 
you set up will be exclusive to your own 
application - it will not be used by any 
operating system routines. 


There remains the problem of finding out 
exactly how much application memory there 
is, so that you can work out where to position 
the stack. This information can be found 
using the call SWI "OS_GetEnv", which is 
short for get environment. The call takes no 
parameters and returns the following results: 

RO = Address of star command 

Rl = RAM limit 

R2 = Address of start time 
The result which particularly interests us is 
R1, which contains the maximum usable 
address plus one. RO points to the star 
command used to.invoke the application, and 
this can be used to read any parameters given 
on the command line. Register R2 points to a 
five byte value that is the time the application 
started in centiseconds from the start of the 
century (00.00 hrs on 1st January 1900). 


MODULE APPLICATIONS 

So far, we have looked mainly at 
applications that are loaded into main 
memory. When it comes to module-based 
applications, much of the material is the 
same, though there are some subtle 
differences. 


We have already mentioned that a 
module-based application can use either the 
application workspace, or claim its own in 
the RMA. To an extent, the choice is 
somewhat arbitrary. Basic uses the 
application workspace for storing the 
current program, plus its own working 
variables and the stack, and doesn't claim 
any RMA at all. It could equally well have 
used the application area solely for the 
program, and claimed some extra memory 
for the stack and its own variables. 


The method of starting a module is also 
different. Instead of a direct call, the module 
is entered using the offset at the start of the 
module header. Details of this process can 
be found in the Modules chapter of the 
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PRM. It is conventional for a module-based 50 [OPT pass 
application to include a star command to 60 ; Find memory limit and set stack 
start it. In this case, the only action the 70 SWI "OS_GetEnv":MOV R13,R1 
command needs to take is to call SWI 80 ; Set up handlers 
“OS_Module" with a reason code of 2. This 90 MOV R4,#&9000:MOV RO, #6 
call enters the module as an application, 100 MOV R2,#&9100:MOV R3,R2 
and hence does not return. Again, for full 110 ADR Rl,error:SWI "OS ChangeEnviron 
details refer to the PRM. ment":STMIA R4!, {RO-R3} 
120 MOV RO, #9:ADR R1,escape 
Exiting a module-based application is 130 MOV R2,#&9000:ADD R2,R2,#&80;SWI " 
done using SWI "OS_Exit", just as fora —0S_ChangeEnvironment":STMIA R4!, {RO-R3} 
normal application. There is however, 140 MOV RO, #11:ADR R1,exit 
another useful call - SWI "OS_ExitAndDie". 150 MOV R2,#&9000:SWI "OS ChangeEnviro 
This performs the function of SWI "OS_Exit", pment": STMIA R4!, {RO-R3} 
but also kills the module as well. 160 : 
170 ; Main program loop 
A SAMPLE APPLICATION 180 .main MOV RO, #0:MOV R1, #59000 
To end this month, we present a simple 190 ADD R1,R1, #&80:STR RO, [R1] 
application program. The function of the 200 SWI "OS WriteS":EQUW &DOA 
program is rather contrived, to show as 210 EQUS "Enter line ":EQUB 0 
many of the aspects covered as possible. 220 MOV RO, #&9200:MOV R1, #6100 
Running the program will assemble the 230 MOV R2,#32:MOV R3, #&FF 
application and save it with the filename 240 SWI "OS_ReadLine":BCS esc 
‘Repeat’. If you run it using *Repeat, you 250 MOV RO, #69200 
will be prompted to enter a string. This is 260 MOV R2,#0:STRB R2, (RO,R1] 
then printed out continually until Escape is 270 CMP R1,#0:SWIEQ "OS Exit" 
pressed. The application terminates when a 280 CMP R1,#30:ADRHI RO, toolong 
null line is entered, and gives an error if the 290 SWIHI "OS GenerateError" 
line is longer than thirty characters. 300 .prt MOV RO, #&9200:SWI "OS Write0" 
310 SWI "OS, NewLine" 
On entry, the application sets up its own 320 MOV R2,#&9000:ADD R2,R2,#&80 
error and escape handlers. The first of these 330 LDR R2, [R2]:TEQ R2,#0:BEQ prt 
displays the error message and returns to 340 .esc MOV RO, #&7E:SWI "OS Byte" 
the prompt stage, while the escape handler 350 B main 
simply sets a flag that is tested by the 360 .toolong EQUD 0 
foreground printing loop. The application 370 EQUS "Line too long":EQUB 0 
also sets up its own exit handler. The reason 380: 
for this is that on exit, the error and escape 390 ; The handler routines 
handlers should be set back to what they 400 .escape MVN RO,#1:STR RO, [R12] 
were on entry. This can be done by installing 410 MOVS PC,R14 
our own exit handler which restores the old 420 .error 
error, escape and exit handlers, and then 430 ADD R1,R0,#8:SWI "OS _NewLine" 
calls SWI"OS_Exit" again to actually quit 440 .err2 LDRB RO, [R1],#1:CMP RO, #0 
the application. This should become clearer 450 BEQ err3:SWI "OS_WriteC":B err2 
if you examine the program. This month's 460 .err3 SWI "OS NewLine":B main 
magazine disc contains both the application 470 .exit LDMIA R12!, (RO-R3} 
as presented here, and a module-based 480 SWI "OS_ChangeEnvironment" 
version of it. Next month we look at multi- 490 LDMIA R12!, {RO-R3) 
tasking applications - particularly those 500 SWI "OS _ChangeEnvironment" 
written as modules. 510 LDMIA R12!, {RO-R3} 
520 SWI "OS _ChangeEnvironment" 
10 REM > RepeatSrc 530 SWI "OS_Exit" 
20 DIM code 400 540 ]NEXT 
30 FOR pass=12 TO 15 STEP 3 550 SYS "OS File",10,"Repeat", &FF8,,co 
40 P%=&8000:0%=code:L8=0%+400 de, 0% RU 
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Reviewed by Mike Williams 


T his package from MJD Software 
provides a comprehensive (some may even 
argue complex) solution to the creation of 
voice modules, by editing amplitude and 
pitch envelopes, waveforms and sound 
samples. Archimedes Voice Generator (AVG) 
is catering for a relatively specialised 
market, which may account for its total 
abandonment of the Wimp environment. If 
one accepts the decision the designers of 
AVG have made here, then the menu 
screens are well laid out, easy to use (with 
some minor criticisms), and form a readily 
understood menu structure. However, I feel 
that it is regrettable that accepted RISC OS 
standards have not been used. 


The package consists of two discs and a 
60 page menu. You may need to reconfigure 
your system before loading the software 
from the Systems Disc (following guidelines 
given in the manual). I had to perform a 
complete reset on my A310 before it would 
load. You are then prompted to insert the 
Data Disc from which a library of sample 
envelopes and waveforms is loaded. 


The main menu screen shows five 
options covering Real-time Synthesis, 
Interpolation Editor, Harmonic Envelope 
Editor, Sample Editor and Disc 
Management. We will look at each of these 
in turn. 


Real-Time Synthesis allows the user to 
create and edit amplitude and pitch 
envelopes and waveforms. The menu screen 
for this feature displays a number of icons 
and messages. The Create option allows any 
combination of waveform and pitch and 
amplitude envelopes to be combined to form 
a voice. A note icon allows a sound to be 
played, or more usefully, a (musical) 
keyboard icon turns the bottom rows of the 
Arc’s keyboard into a musical keyboard, 
with a choice of four octaves. Unfortunately, 
you have to exit from this keyboard if you 
want to change the current voice (and this 
annoyance applies to all other edit screens 
where this facility is available). 


Archimedes Voice Generator from MJD 


Up to eight voices can be created and 
saved as a sound module. These voices can 
then be used with the Maestro application, 
or any other software using voices. The 
default library, loaded at the outset, 
contains 18 waveforms, 15 amplitude 
envelopes and 14 pitch envelopes. Each 
sound library of this kind can contain up to 
20 examples of each. 


To edit (or create) an amplitude 
envelope, you click on the appropriate icon. 
A further screen appears with a large graph 
display (of the envelope), and various 
control icons. Rubber-banding is used to 
create envelopes. You can also specify any 
part of the envelope to be repeated for as 
long as the note is being played (key 
pressed). All of the features of the envelope 
can be changed or removed, and you can 
cycle through all the amplitude envelopes in 
the currently loaded library from this 
screen. 


Pitch envelopes cam be similarly created 
and edited. Again part of the envelope can 
be specified as a loop. In addition the 
vertical scale of the envelope can be in 
terms of semi-tones, or octaves. 


The waveform editing screen is different 
from the two already described. It shows on 
screen all 20 waveforms from the currently 
loaded library (marked blank where 
appropriate). Furthermore, waveforms can 
be defined either in terms of harmonics or 
by means of a hand-drawn waveform - and 
the sample library includes both. The screen 
display changes according to the method by 
which a waveform is to be (or was) defined. 
If harmonics are used, then the equivalent 
graph is shown as well. Harmonically 
created waveforms are always mirrored 
about the fundamental, but hand-drawn 
waveforms can be mirrored or not as the 
user wishes. 


Again, whatever format is used, all 
waveforms can be edited and changed as 
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required. Hand-drawn graphs can be 
created with rubber-banding, or continuous 
drawing (or a combination of both). 


The second main menu option is called 
the Interpolation Editor. The function of 
this can be explained by analogy with 
cartoon animation, whereby intermediate 
frames are automatically generated between 
two main frames, a process often called 
inbetweening. Here, one waveform can be 
transformed into another to give moving 
colour to a sound (just as an amplitude 
envelope gives moving volume, and the 
pitch envelope gives moving frequency). In 
practice, two or more points in an amplitude 
envelope are selected and associated with 
specified waveforms. Selecting Confirm 
causes the interpolation to take place. 
Further amplitude envelopes and selected 
waveforms can be combined with the first 
interpolation. 


The sound created with the 
Interpolation Editor is saved as a Sound 
Data Block (SDB). This is the common data 
structure used throughout AVG, and is 
equivalent to a sound sample at 20.833 
KHz. SDBs can be used with the Sample 
Editor (qv) to create voice modules. 


The third main menu option, the 
Harmonic Envelope Editor, provides a 
similar function to the Interpolation Editor 
just described but in terms of harmonics. In 
effect, a separate amplitude envelope is 
applied to each harmonic in the waveform. 


An important function of AVG is the 
Sample Editor. An example SDB loaded 
from the Data Disc is first shown as a 
time/amplitude graph. This can also be 
viewed as a sequence of waveforms. Each 
waveform in the sequence can be displayed 
separately on a graph and edited directly as 
with the waveform editor. As well as editing 
SDBs, the Sample Editor can also load 
genuine sound samples and convert them 
into SDBs for further editing. Such samples 
must also be tuned to the Archimedes on- 
board Voice module pitch standard, before 
conversion to an SDB, another facility 
provided by AVG. 


All samples saved in the form of an SDB 
can then be used to create a voice module, 
either in multi-voice format with up to eight 
voices per module, or in multi-layered 
format where a single voice is assigned the 
whole module as eight samples exactly one 
octave apart. In the latter case, the sample 
nearest in pitch to that of the note being 
played is used at any time. 


Because AVG is not a multi-tasking 
Wimp application it must provide all its own 
disc management facilities. These appear 
partly in each of the options already 
described for the saving and loading of 
libraries, SDBs and voice modules, and also 
in the fifth option, Disc Management, in the 
main menu. There is also a very 
comprehensive on-line help system, again 
custom written for AVG. 


CONCLUSIONS 


As I hope you will appreciate, AVG 
provides a tremendous wealth of facilities 
for voice creation. This is quite daunting 
initially, and the manual must be read 
carefully if all the features are to be 
understood. The manual is tutorial in 
approach, and makes extensive use of the 
supplied libraries and example SDBs. 
However, one of the manual references 
seems incorrect, and there is the occasional 
minor hiccup in the software, though never 
anything too catastrophic. 


I feel that even after several hours of 
working with this software I have only 
scratched the surface of what it is possible 
to achieve. If you want to extend the in-built 
range of voices, play around with sound 
samples, or create highly sophisticated 
acoustic effects then I do not believe you can 
do better than use AVG. It’s not the easiest 
of packages to master, but I have seldom 
seen one which is so comprehensive and has 


‘so much to offer in its field. 
Product Archimedes Voice Generator 
Supplier MJD Software 
13 Burnham Way, 
West Ealing, 
London W13 9YE. 
Tel. 081-567 4284 
Price £59.95 (VAT not applicable) RU 
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Stepped Renumber 


Alan Wrigley presents a utility which will smarten up your listings. 


S ome while ago, BEEBUG magazine 
published a utility for the BBC micro to 
renumber a Basic program in stages, with 
initial REM lines starting from line 10, the 
main program from line 100, and procedures 
from line 1000 onwards. The StepNum 
utility presented here does the same thing 
for the Archimedes. It will operate on any 
Basic program in memory, and has been 
designed so that it can be easily used with 
our BEdit application (RISC User Volume 3 
Issue 4) which provided a Wimp front end 
for the Basic editor. However, StepNum will 
work perfectly well without BEdit. 


The listing given here is the source code 
which assembles and saves a machine code 
utility. Type in the listing, then save and run 
it. The machine code will be assembled and 
filed as StepNum. If you wish to use it from 
BEdit, you should place this file within 
BEdit’s application directory, and add the 
following line to BEdit’s !RunImage program: 

1585 *Key8 <0><&94>REN. |M*/<BEdit$Dir>. 
StepNum|M 
Pressing Shift-Ctrl-F8 within the Basic 
editor will run StepNum and return to Basic. 


Alternatively, you can file StepNum in 
the library directory of the current disc and 
invoke it from Basic by typing *StepNum. 


HOW IT WORKS 

One of the difficulties in renumbering any 
program is the way in which references to 
line numbers are made following a GOTO or 
a RESTORE statement. For very good 
reasons, which we will not go into here, these 
numbers are tokenised into 4 bytes, the first 
of which always has a value of &8&D. When 
renumbering, these references must be 
found, and the new line number tokenised 
and inserted in place of the old. StepNum 
does this by scanning through the program in 
the first instance looking for tokenised 
numbers. When it finds one, the number is 
detokenised and stored in the utility’s 
workspace, together with the address at 
which it is located in the program. There is 
enough space for 128 GOTOs or RESTOREs - 
should your program contain more than this 
a “no room” error will be generated. 


Having compiled a list of tokenised 
numbers, the utility then goes through the 
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program again line by line, looking at the 
first program character on each line (i.e. 
spaces are ignored). A flag is incremented 
when the first line not starting with REM is 
found, and incremented again when the first 
DEF is found. The new line number is 
calculated, numbering in increments of 10 
from 10 while the flag is zero, from 100 
while it is 1, and from 1000 while it is 2, 
unless 100 or 1000 respectively has already 
been used, in which case the next available 
increment of 10 is used. 


The old number is then checked against 
the list of tokenised numbers, and if any 
matches are found, the new number is 
tokenised and inserted in place. Finally the 
current line is correctly renumbered. 


StepNum does not trap non-existent 
tokenised line numbers, i.e. GOTO nnnn 
where nnnn does not exist. It is a good idea in 
any case to perform a standard renumber 
using the Basic command RENUMBER 
before running StepNum, to ensure that the 
program has sensible line numbers to start 
with. The call from BEdit listed above does 
this. Any non-existent line numbers will be 
reported at this point by Basic. 


PAGE, as set in line 140, is &8F00 by 
default but cannot always be guaranteed. 
For more information on PAGE, see this 
month's Hints & Tips. 


This month’s magazine disc contains a 
modified version of BEdit incorporating the 
facility to call StepNum as described above, 
and also including the amendments detailed 
in last month’s Hints & Tips to print out 
listings from the Basic Editor using PCol. 


10 REM >SNsource 
20 REM Program Stepped Renumber 
30 REM Version Al.2 


40 REM Author Alan Wrigley 
50 REM RISC User July/August 1990 
60 REM Program Subject to copyright 


100 pe=15:link=14:sp=13:base=12 
:01ld=9;con=8:ad=7 


140 DIM code% 1000:max%=20 :page=&8F00 
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GRAPHBOX 


- THE GRAPHICS 


With twenty graph types and its multi-tasking capabilities 
GraphBox is one of the most flexible packages for the 
‘Archimedes. Enter data through Graph Edit or drag data in from 
any other legal multi-tasking software and produce a graph which 
can then be exported to a wordprocessor or DTP package. 
GraphBox gives you a professional graph in a’ matter of minutes, 
whether you require a simple scatter or a more complex polar 
chart. These features plus the ability to enter formulae on the X, Y 
or Z axis and save it to the Acorn Draw or Edit applications make 
GraphBox an impressive data presentation package. 


MULTISTORE 
- THE DATABASE 


A multi-tasking, relational database allowing many database files 
to be opened at one time. Files may be linked so that relationships 
between files are automatically tacked. Rapid searches by any 
criteia, including ‘sounds like’ facility. Key fields for fast search, 
indices to allow file browsing in more than one order without 
sorting. Fast sort facility by single field or complex expression. 
Comprehensive reporting facilities allow any report, including 
totalled lists of fields, labels with multi-font capability, line trapping, 
justification, paging, multi-set stationery and even completely 
relational reports. 


ATELIER 


- THE STATE OF THE ART 


An art package in a class of its own, Atelier exploits the 256 colour 
capabilities of the Archimedes. Stunning graphics can ba created 
easily and professionally. Atelier is multi-tasking which means your 
pictures or artwork can be exported to a DTP package by simply 
dragging them across. Comprehensive sprite editor, undo brush, 
patterns and definable brushes. Extremely smooth fill routines, 
ability to import digitised images and advanced features which 
allow you to wrap images onto any definable 3D shape coupled 
with the Sequencer to animate your images - only your 
imagination can hold you back. 


PROFESSIONAL SOFTWARE FOR THE ARCHIMEDES & A3000 


Ne Rae OF eX, 


SOFTWARE 
69 SIDWELL STREET, EXETER EX4 6PH. TEL:(0392) 437756 FAX: (0392) 424762 


Stepped Renumber 


150 
160 


FOR I%=4 TO 7 STEP 3 
P3=0 :0%=codes 


170: 


180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 


(OPT I 

STMFD (sp) !, {link}:MOV flag, #1 
MOV gen, #15:MOV env, #0 

SWI "XOS_ChangeEnvironment" 
BVS exit:MOV reg, env:MOV gen, #18 
ADR env,basic:SWI "XOS_Module" 
BVS exit 

CMP reg,mod:ADRCC gen, notbas 
BCC exit:LDR gen, [mod, #-4] 

ADD mod,mod,gen:CMP reg,mod 
ADRCS gen, notbas:BCS exit 

MOV start, #page:MOV len, #1 
MOV blk, base 


-detok 

BL getline:BEQ number 
.readloop 

LDRB gen, [ad], #1 


CMP gen, #13:BEQ detok 

CMP gen, #229:CMPNE gen, #247 

BNE readloop 

skip 

LDRB gen, [ad] ,#1:CMP gen, #32 

BEQ skip:CMP gen, #141:BNE readloop 
STR ad, [blk], #4:LDRB gen, [ad], #1 
MOV gen, gen, LSL#2:AND reg, gen, #&C0 
LDRB con, [ad], #1:EOR reg, con, reg 
STRB reg, [blk], #1:LDRB con, (ad), #1 
EOR reg, con, gen, LSL#2 

STRB reg, [blk], #3:SUB gen, sp, #8 
CMP blk,gen:ADRGE gen,noroom 

BGE exit:B readloop 

«number 

MOV start, #page:MOV flag, #0 

MOV new, #0:MOV len, #1 

STR new, [blk] 

-numloop 

BL getline:MOVEQ flag, #0:BEQ exit 
first 

LDRB gen, [ad], #1 

CMP gen, #32:BEQ first 

CMP flag, #0:BNE main 

CMP gen, #&F4:CMPNE gen, #58 

BEQ check 

MOV flag, #1:MOV new, #90 

CMP new,old:MOVLT new, old 

«main 

CMP flag, #1:CMPEQ gen, #&DD 

BNE check:MOV flag, #2 

MOV new, #1000:SUB new, new, #10 

CMP new,old:MOVLT new,old 
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680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 
990 
1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 


«check 

ADD new, new, #10:MOV blk, base 
.checkloop 

LDR ad, [blk], #8:CMP ad, #0 

BEQ store:AND gen, old, #&FF 

LDRB reg, (blk, #-4] :CMP reg,gen 
MOVEQ gen, old, LSR#8 

LDREQB reg, [blk, #-3] 

CMPEQ reg,gen:BNE checkloop 

MOV con, #&40:AND reg, new, #&3F 
ORR reg, reg, con:STRB reg, [ad, #1] 
MOV reg,new, LSR#8:AND reg, reg, #&3F 
ORR reg, reg, con:STRB reg, [ad, #2 
AND reg, new, #&C0:MOV gen, new, LSR#8 
AND gen, gen, #&CO 

ORR reg, reg, gen, LSR#2 

EOR reg, reg, #650 

ORR reg, con, reg, LSR#2 

STRB reg, [ad] :B checkloop 

«store 

STRB new, (start, #1] 

MOV reg, new, LSR#8 

STRB reg, [start] :B numloop 
-getline 

ADD start, start, len 

LDRB reg, (start, #-1] :CMP reg, #13 
ADRNE gen, badprog 

MOVNE flag, #1:BNE exit 

LDRB old, [start] :CMP old, #255 
LDRNEB reg, [start, #1] 

ADDNE old, reg, old, LSL#8 

LDRNEB len, (start, #2) 

ADDNE ad, start, #3:MOV pc, link 
exit 

CMP flag, #0:LDMEQFD (sp)!,{pc)* 
LDMFD (sp) !, {link} 

ORRS pe, link, #1<<28 

-basic 

EQUS "BASIC":EQUB 0:ALIGN 
.badprog 

EQUD 0:EQUS "Bad program" 

EQUB 0:ALIGN 

-horoom 

EQUD 0:EQUS "No room for renumber" 
EQUB 0:ALIGN 

-notbas 

EQUD 0:EQUS "Not a Basic program" 


1150 EQUB 0:ALIGN 

1160 } 

1170 NEXT 

1180 SYS "OS File",10,"StepNum", &FFC, ,c 

ode%, 0% 

1190 END RU 
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The Best Solution 
Ovation provides a single solution to all of your desktop 
publishing and word processing needs, Combining the most 
useful and powerful features from DTP systems costing much 
more, you will find Ovation has just about everything you 
could want. Ask your dealer for a demonstration- you won't 
be disappointed, 


Text Editing 
‘Text may be typed in straight away just like a word 
processor, without the need for any complicated frames or 
styles, When a page is full, text will simply flow onto the next 
page. In addition you may add any number of frames to the 
page, each with its own ‘story! Frames may be linked together 
causing the ‘story’ to flow from frame to frame. 


Adding Style 

A ‘style’ is the font, size, justification, leading, indent etc. 
of a piece of text, Ovation allows any number of styles to be 
defined, named and then 
applied to paragraphs at 
the press of a key. Styles 
may be re-defined at any 
time, and the changes will 
automatically flow through 
the entire document. 
In addition, local styles 
may be applied to any 
highlighted block by simply selecting the font, size, style and 
format from the menus. 


Frame Handling 

Ovation has many advanced frame features, such as 
linked text frames with auto-flow, repel text, definable frame 
borders and a step-and-repeat facility. Unique on the 
Archimedes, is our parent/child system for frames and lines. 
This system allows you to copy and paste frames with 
embedded child frames and lines, as single items. This allows 
diagrams, forms, tables etc. to be copied or moved with ease. 


The Instinctive DIP 

Ovation is supplied with a tutorial and complete user 
guide, although you probably won't need to refer to it very 
often. Ovation makes full use of the RISC OS multi-tasking 
environment to provide a formidable array of features that 
are easy to learn and instinctive to use. A quick reference 
card is also included, which lists all the keyboard and mouse 
short cuts. 


Other Features 
Multi-tasking/multi-documents No hardware protection 
Full WYSIWYG display with variable view 
Fast built-in spelling 
checker (requires 2Mb) 

Printer drivers for Epson, 
PostScript, LaserJet, and 
Integrex printers 

Import Draw and Sprite 

files. Features include: 

scale, crop, fit-to-frame 
Master pages for each chapter 
Cut/copy/paste using clipboard 
Multiple columns» Find and replace 
Automatic headers and footers 

Supplied with 4 outline fonts (13 faces) 
Variable (& fractional) font sizes Ipt to 500pt 
Supports coloured text, frames and borders 
Stylesheets and customised start-up 
Definable frame borders 

Linkable text frames 

Supplied with full range of clipart 

Variable size, style and colour lines 

Manual and auto hyphenation (requires 2Mb) 
And much, much more...... 


° 
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Excellent Value 
At only £99 plus VAT Ovation represents better value for 
money than any other DTP on the Archimedes/A3000. 
But don't be mislead by price. We are confident you will be 
impressed, and offer a full refund if not completely satisfied. 
Educational discounts and site licences are available. 


(+£3 carriage) plus VAT 


Available directly from Beebug or from your local dealer. 
Please phone for a full specification. 


eebug Ltd, rn 
117 Hatfield Ra, St. Albans, Rie’ re L 
Herts, ALI 4S Lou | | 


Tel: (0727) 40303 Fax: (0727) 60263 
Ifyou wish to order directly, cheques, credit cards and 
official orders are all welcome. 


Introducing C (Part 2) 


David Spencer looks at choosing and using a C compiler. 


F ollowing last month's introduction 
to C, this time we look at the choice of C 
compilers and explain how to go about 
using one when you have purchased it - 
a task which may seem rather involved 
to a programmed used to Basic. 


CHOOSING A COMPILER 

There are currently two C compilers 
available for the Archimedes. The first is 
ANSI C from Acorn which is now in its 
third version. The alternative is 
Beebug's own ISO C. We will start by 
looking at the features of the two 
compilers, and then give an example of 
their use. 


Fundamentally, both compilers perform 
the same functions. They both conform to 
the final ANSI standard as closely as 
possible, and both include the RISCOS_LIB 
library functions mentioned in the previous 
article. There are however some major 
differences between the two packages. 


Perhaps the most striking difference is 
that Acorn ANSI C is command line driven, 
while ISO C runs under the Wimp in 
addition to the command line. 


As well as the compiler and linker, ANSI 
C also includes a make utility and symbolic 
debugger, both of which are described later, 
and also various utilities to convert to and 
from the older Kernighan and Ritchie C 
standard. There is also a special assembler, 
called Cmhg, which allows relocatable 
modules to be written in C. However, the 
one essential that ANSI C does not include 
is a text editor to allow the source code to be 
entered in the first place. This is not a major 
problem though, as all users will have a 
suitable editor in the form of RISCOS Edit. 
You may also be able to use your favourite 
word processor or DTP package, provided 
that it can save a document as plain text 
with no embedded control codes. 


If you are using ANSI C to develop major 
applications, it may be wise to consider 
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Figure 1 


Acorn's Twin. This is a special twin-window 
editor which allows up to twenty different 
documents to be loaded, and any two 
displayed simultaneously. A very useful 
feature of Twin is that you can use one of 
the windows to run the compiler in, while 
viewing the source code in the other window. 
When compilation errors occur, you can 
automatically cross reference into the source 
code. Twin is not Wimp-based, and many of 
its features can be performed using Edit's 
Task Window facility. However, many 
programmers prefer Twin. 


The ISO C Desktop environment 
includes its own editor, which is similar in 
operation to Edit. Text is entered as per 
normal, and text files can be loaded, saved, 
or transferred to other applications. 
However, the real advantage is that 
pressing the Menu button over the editor 
window brings up a menu allowing the 
program to be compiled, linked and even 
run. All the compiler and linker options can 
also be set via a submenu, alleviating the 
need for lengthy commands to be typed in 
with flags for various options. Furthermore, 
after an unsuccessful compilation, the lines 
in which errors occurred can be highlighted 
in the editor window automatically. 


One area where Acorn's ANSI C excels is 
that of code optimisation. This is the process 
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of adjusting the ARM code produced by the 
compiler to make it as efficient (and short) 
as possible. There are many types of 
optimisation, and if done properly the speed 
increase can be very significant. The ANSI 
C compiler optimises on a function by 
function basis, rather than statement by 
statement, and can produce very efficient 
code - in some cases as good as if it was 
written manually in ARMcode. 


A very useful function of ISO C is the 
ability to set up projects. Basically, a project 
is a collection of the source files making up a 
complete program, together with a makefile 
(see later), and the compiled code. Facilities 
are provided to allow a project to be treated 
as a whole, and to compile an entire project 
in one go. 


INSTALLATION 

Both C compilers have to be installed in 
some way or another before they can be 
used. If you have a hard disc drive then the 
compiler can be copied onto that, and 
various directories set up to provide an 
‘environment’ for developing C programs. 
The documentation for each compiler 
describes the details of this process. If you 
only have a floppy drive then it is still 
necessary to create a working disc as it is 
unwise to modify the original master. Both 
versions of C also have a new ‘CLib' module 
which must be installed into the /System 
folder. 


The layout of the two C systems on disc 
is different. ISO C is supplied on two discs. 
One of these contains the compiler 
application and this must be loaded before 
the compiler can be used. This registers 
itself as a large C on the icon bar. The 
second disc contains a pseudo-application 
directory called /IsoCWork which contains 
the standard header files and libraries. This 
disc must be present (or a copy of it) to allow 
the compiler to access header and library 
files during the compilation process. 


The disc structure of ANSI C is rather 
more complex, spreading over three discs. 
The first disc is the work disc which 
contains the compiler, linker, the other 
utilities, compressed versions of the 


RISC_OSLIB header files and a number of 
examples. An interesting feature of ANSI C 
is that it doesn't need the ANSI header files 
to be on disc, as they are built into the 
compiler itself. The second disc contains the 
object code for the libraries along with the 
ANSI header, while the third disc contains 
more examples and un-compressed versions 
of the RISC_OSLIB headers. , 


COMPILING A PROGRAM 
Armed with a working copy of your 
compiler, the moment of truth draws near - 
compiling your first program. As a starting 
point, we will use the example program 
given in last month's article. This is 
provided on this month's magazine disc for 
convenience. We will also assume that you 
are running the compiler from floppy disc. 


The first stage, assuming that you do not 
have the magazine disc, is to enter the 
source code as a plain text file. With ANSI 
C, you should enter the source code using 
Edit, and save it in the directory $.User.C 
on your working disc. For argument's sake 
we will call the file 'Tables'. With ISO C, you 
should run the compiler application and 
click on the icon bar icon to open an editor 
window. The source code can then be 
entered and saved in the directory 
$.programs.c by choosing the 'Save all' menu 
option and entering the name. 


The next stage is the compilation and 
linking. If you are using ANSI C then you 
will need to leave the Desktop and enter the 
following commands: 

*MOUNT 0 

*LIB $.LIBRARY 

*DIRUSER 

*CC Tables 
The first three lines make sure that the 
current directory is set correctly, and that 
the compiler and linker can be found. It is 
the final line that actually invokes the 
compiler. This is the simplest form of the ‘cc’ 
command, and takes the file Tables from the 
subdirectory c, compiles it, and places the 
resulting object code in the directory o, 
keeping the same filename. The compiler 
then automatically invokes the linker, which 
links in the libraries as needed, and saves 
the executable code in the current directory. 
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To compile using ISO C, all you need do 
is choose the Compile option from the main 
menu, followed by the Link option to 
perform the linking stage. 


Now, assuming everything went OK, you 
can actually execute the code. With ANSI C, 
enter the command; 

Tables 
to run the compiled program. You should see 
the output as shown in figure 1. To execute 
the program under ISO C, simply choose the 
Run option from the main menu. 


MAKING IT WITH MAKE 


If you think that the process of compiling 
a simple program is involved enough, 
consider what happens when you have a 
massive project spread across several C 
source files, along with a variety of header 
files, and some special patches written in 
ARM assembler for good measure. The 
situation can very quickly become too 
complex to handle. In particular, the 
problem of keeping files up to date is often a 
major headache. For example, if one of the 
source files is altered, it needs to be 
recompiled and then relinked, but it is not 
necessary to recompile the files that have 
not changed. On the other hand, if a common 
include file (see last month's article) was 
changed, then all the source files that 
included it would need recompiling. 


Fortunately, both ANSI C and ISO C 
offer a solution to this by way of a Make 
utility. The operation of such a utility is too 
complex to explain in detail here, but 
basically it works by examining the date 
stamps of all the necessary files and using a 
list of dependencies held in a file called the 
Makefile to decide what action to take. For 
example, an object file is only up to date if 
all its source files are older than itself. If 
this is not the case, then the Make utility 
will issue the appropriate commands to 
recompile the object code from the sources. 


The Make utilities provided with ANSI 
C and ISO C are different, though they both 
perform similar functions. In particular, the 
format of the Makefile that specifies the 
dependencies and actions differs between 
the two packages. In common with the other 


RISC User July/August 1990 


parts of the system, the ANSI C Make, 
called Amu (A Make Utility) is command 
line driven. With ISO C, the Make utility 
can only be used as part of a project. In this 
way, each project can have its own Makefile 
within it, and can be made up to date by 
selecting the appropriate project followed by 
the Make option. 


COPING WITH ERRORS 

Error handling with interpreted 
languages such as Basic is fairly 
straightforward. The program runs until an 
error occurs then stops. The error can either 
be a coding error, such as a wrong variable 
name or a misspelt keyword, or a run-time 
error such as trying to divide by zero. 


Errors in C are a different kettle of fish. 
In particular, different errors manifest 
themselves at different points during the 
compilation cycle. Syntax errors such as 
incorrectly formed statements are picked up 
at the compilation stage, while errors such 
as misspelt variable names will be 
discovered by the linker. 


C splits compilation errors into three 
classes. The least serious are warnings, and 
usually indicate a correct, but unusual, 
programing construct. The next level up are 
errors where the compiler can make an 
educated guess at the problem and fix it 
automatically. The final set of errors are 
those that are so serious that compilation 
must stop immediately, If the compiler is 
unable to continue, the linking stage is not 
performed. Similarly, if the linker fails, no 
executable code is produced. Run-time 
errors are reported as they happen, and as 
with Basic, it is possible to trap them with 
your own error handler routine. 


ANSI C provides a symbolic debugger as 
part of the package. This allows a compiled 


» program to be stepped through instruction 


by instruction, examining variables as you 
go, among other things. ASD, as the 
debugger is called, is a very powerful and 
useful tool. 


Next month, Dec McSweeny takes over 
this series and starts looking at C 
programming in detail. RU 
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Assembler 
made Easy 


(and cheap) 


Assembly language is often the me to fast, efficient programs - but you don’t want the 
clumsiness of the Basic assembler. 


At around £200 most assemblers just aren’t an option for most individuals - only 
software houses. But there is an alternative to high cost - high volume. Now Express 
Software has taken just that route. 


Could you use these features? 


Assembles 27,000 lines per minute 
Floating point instructions 
Macros and conditional assembly 
Two types of libraries 
Enhanced addressing modes 
Compatible with Acorn Link 
Links to Acorn C modules 


Do you want to: 


Develop relocatable modules 
Exploit the graphics of your machine 
Speed up time-critical routines 
Perhaps even write that game? 


-then the Express Assembler is for you. At only £29.95 (no VAT). Simply fill in the 
coupon below and return to Express Software, 56 Looe Road, Felixstowe, Suffolk IP11 
9QB - and look forward to the speed and sophistication of Express Assembler! 


I understand that I will be invoiced for £29.95, the price 
of Express Assembler. I am over 18 years of age. 


Signed 


Computer Concepts’ LaserDirect Printer 


Reviewed by Alan Wrigley 


T ceeauy there are two main ways 
of sending output to a laser printer (see 
Into the Are elsewhere in this issue). You 
can compile and send a bit-map of the 
image, and the printer’s own software will 
analyse the data and control the operation 
of the print engine to achieve the desired 
result on paper. Or you can prepare a 
PostScript program and send this to a 
PostScript printer, where again it is 
processed by the printer’s own software. 
Either way, it is necessary for the printer 
to have a considerable amount of 
processing power, and also large amounts 
of RAM to hold images of any size. In the 
case of PostScript, the printer must also 
hold all the fonts to be used, either 
resident or downloaded. 


All this makes laser printers expensive, 
and can introduce a time delay unless the 
printer’s processor is extremely powerful. 
Computer Concepts’ idea is delightfully 
simple - you already have one of the fastest 
micros on your desk, so why not 
use the power of the Arc to 
drive the printer? 


The result is the LaserDirect. 
The package consists of a “dumb” 
print engine, and a software 
expansion card which fits into an 
Archimedes equipped with a 
backplane. At least 2Mbytes of RAM is 
recommended (though you might just get 
away with 1Mbyte if you print to file and 
then quit your application before sending to 
the printer), All the processing is done by 
this software, and the print engine is driven 
directly from am output port on the card. 
Optimum speed is achieved by operating 
under interrupts, and use of RAM is 
maximised by storing the print information 
in a compressed format. The LaserDirect 
therefore claims a high level of 
performance. 


‘THE PACKAGE 

The LaserDirect uses the same Casio 
engine and casing as in the Qume 
CrystalPrint page printer, and therefore 
looks identical. For full details of the 
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Standard Draw File 39s 47s 
Mode 12 screen 45s 71s 
Impression A4 page 39s 69s 


ergonomics of the machine, and the cost of 
consumables, see the review of the 
CrystalPrint Publisher in RISC User 
Volume 3 Issue 4. The software supplied for 
review was not in its finalised form, but 
was sufficiently developed for all major 
functions to be performed. The software is 
contained in a ROM on the expansion card, 
and will have an auto-boot facility built in 
allowing you to install the printer driver 
automatically on start-up. 


PERFORMANCE 

The review sample was only available 
for a short while and so I could not carry 
out any exhaustive tests. However, I was 
able to make some direct comparisons 
between the performance of the 
LaserDirect and both the Panasonic KX- 
P4450 Laserjet compatible, and the Qume 
CrystalPrint Publisher Postscript printer 
(see RISC User reviews in Volume 3 
Issues 3 & 4), Figure 1 shows comparative 
timings for the three machines. 


Qume Panasonic 
Publisher KX-P4450 


LaserDirect 


3m 33s 
2m 43s 
6m 35s 


Figure 1. Comparative timings for the 3 printers 


You will see that, for the sample files 
printed, the PostScript printer is 
considerably faster than the Panasonic, 
but the LaserDirect is even faster still. 
You must bear in mind, though, that the 
speed of a non-PostScript printer is 
dependent to some extent on the 
configuration of your computer. For 
example, all these tests were done with a 


, font cache of 64K, and fonts installed on a 


hard disc. If you have to use a smaller font 
cache because of memory constraints, and 
you are accessing fonts from a floppy disc, 
then the time taken to print on the 
LaserDirect will increase, whereas the 
PostScript printer, with its built-in fonts, 
will not show any difference in speed. 
Nevertheless, when you consider that the 
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Computer Concept's LaserDirect Printer 


Laser Direct is priced at less than half the 
cost of the cheapest PostScript printer, it 
still represents remarkable value in terms 
of printing speed. And although I did not 
have an ARM3 available for testing, 
Computer Concepts claims that this will 
increase the speed by up to three times. 


FUTURE DEVELOPMENTS 
Computer Concepts is already 
planning to develop the LaserDirect 
concept further. An expansion card will be 
available to drive the Canon LPB4 print 
engine at a staggering 600 d.p.i. This 
engine is readily available, and the total 
cost of printer and software will be around 
£1500 (inc. VAT), bringing near typeset 
quality into the reach of the mass market 
for the first time. Also coming soon will be 
a PostScript compatible interpreter which 
will turn the Archimedes and LaserDirect 
into a very fast PostScript compatible 
printer, but using the Acorn outline fonts 
instead of resident fonts in the printer. 


CONCLUSIONS 
Although this was only a brief review, 
clearly this printer is an exciting 


development in the Archimedes world. 
With professional DTP packages now 
appearing, a fast, inexpensive printer such 
as the LaserDirect makes the Arc look an 
extremely attractive system for desktop 
publishing. There is a drawback, however. 
Because the printer has no intelligence of 
its own, it is dependent upon the 
Archimedes which drives it. If you decide to 
change to a different system, you cannot 
use the LaserDirect with it as you would be 
able to with other printers. However, it will 
be possible to upgrade the printer to any 
other in the Qume range, which would 
overcome this problem, but at a price. 
Nevertheless, if you are satisfied that your 
Archimedes will be around for a while, 
then I cannot see any better value for 
money on the market at present. 


Product LaserDirect printer 
Supplier Computer Concepts 
Gaddesden Place, 
Hemel Hempstead, 
Herts HP2 6EX. 
Tel. (0442) 63933 


Price £1148.85 Inc. VAT 


AW 


"FIRST" 
ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; “Industry Standard" machines 
A powerful and practical tool for Research, Industry, Business, and Teaching 


Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 


Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 
ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 
One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 


There's far too much to describe here. Get full information now from: 


Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 ISD Tel. 051 327 4268 
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by Lee Calcraft 


T he Scroll Lock key (next to the Break 
key) can be used to freeze the screen at 
any time during the display of text under 
VDU4 control. By the same token if a user 
presses the key without realising it, the 
application he is running will appear to 
hang. This does not occur within the 
Desktop environment because VDU5 
graphics mode printing is used, but for 
other applications this can be something 
of an embarrassment. 


The only way around the problem is to 
install some ARM code which periodically 
switches off the Scroll-Lock. This is what 
the accompanying program does. Once 
every second it switches off the Scroll 
Lock, and switches on the Number Lock. 


To use the program, type it in carefully 
and run it. From that point on, until the 
machine is reset, the Scroll and Number 
Locks will be controlled as stated. To 
cancel the effect, you can type 
PROCscrollfixoff. Alternatively you can 
reset your machine by pressing the Reset 
key or powering up. The two procedures 
PROCscrollfix and PROCscrollfixoff are 
intended to be incorporated into other 
programs. If you do this, you should call 
PROCscrollfix once and once only at the 
start of the program, and PROCscrollfixoff 
once and once only at the end (whether 
the program ends via an error condition or 
not). You should not attempt to load other 
software while the fix is active, since the 
event handling code will be over-written 
by the new program. 


HOW IT WORKS 

The program works by setting up a 
periodic event. This is achieved using SYS 
“OS_CallEvery” (PRM page 572). The two 
parameters supplied with this call are the 
number of centiseconds between each call 
(100 in this case), and the address of the 
code to be executed each time the event is 
invoked. 


The code to assert the Lock keys is 
simple, making use of OS_Byte 202 to set 
the two Lock states (see the PRM page 
511) and OS_Byte 118 to make sure that 
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Disabling Scroll Lock ——__— 


the new state of these keys is reflected in 
their LEDs. 


The code surrounding these two calls is 
used to stack the return address. This is 
essential since if a second event occurred 
during the processing, the return address 
would be lost. This is complicated by the 
fact that the return address of the SWI is 
stored by the ARM in R14_sve, so the first 
part of our code must change to sve mode 
in order to stack R14_svc. The reverse 
occurs on exit. 


10 REM >scrloff4 
20 REM Program Scroll Lock Off 
30 REM Version A 0.4 


40 REM Author Lee Calcraft 
50 REM RISC User July 1990 

60 REM Copyright Lee Calcraft 
10: 

80 PROCscrollfix 

90 PRINT"Scroll fix installed" 
100 END 

110: 

120 DEFPROCscrollfix 

130 DIM code% 100 

140 FOR opt%=0 TO 2 STEP 2 

150 P$=code%; (OPT opt% 

160 .action 


170 STMFD R13!,{RO-R2,R8,R9,R14) 


180 MOV R9,PC \save PC 

190 ORR R8,R9,#3\get svc ver of PC 
200 TEQP = R8,#0 \enter svc mode 
210 MOVNV RO,RO \null opcode to 
220 \avoid contention 
230 STMFD R13!, (R14) 

240 \ 

250 MOV RO, #202 \OS_Byte 202 

260 MOV R2,#249 \assert locks 

270 MOV R1, 40 

280 SWI "XOS_Byte" 

290 MOV RO, #118 \OS Byte 118 

300 SWI "OS_Byte"\do leds 

310 \ 

320 LDMFD R13!,{R14}\restore R14 sve 
330 TEQP R9,#0 \re-enter orig mode 
340 MOVNV RO,RO \null opcode 

350 LDMFD R13!, {RO-R2,R8,R9,PC)* 

360 |NEXT 


370 SYS "OS_CallEvery",100,action 

380 ENDPROC 

390 

400 DEFPROCscrollfixoff 

410 SYS "OS_RemoveTickerEvent",action 
420 ENDPROC RU 
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MORLEY £.L.E.C.T.R.O.N.1.C.S. 


SPECIAL OFFER 
Buy any Archimedes and get 
an extra 1MB RAM fitted for 

only £50 or a free A3000 
Analogue & User Port Podule. 


Archimedes 


THE WORLDS 
MOST POWERFUL 
MICRO 


3000 £599 
410/1 £1099 
420/1 £1699 
440/1 £2099 
Learning Curve £699 


Colour Monitor £199 
Mono Monitor £73 
A3000 

Monitor Stand £29 
User Port & Midi Podule £49 
Serial Upgrade £19 
Econet Upgrade £49 


ARCHIMEDES PERIPHERALS 


300/400 SERIES 


Acorn Rom Podule £56 
2 Slot Backplane £37 
4 Slot Backplane £59 
1/0 Podule £80 
Midi Podule £65 


Second 3.5" Drive £115 


MEMORY EXPANSION 


THE BEST VALUE MEMORY UPGRADES 


-Fully compatible with all 
Acorn software. 

-A must for all serious 
Archimedes owners. 

-Make full use of powerful 
RISC-OS packages. 


Unlike most other 
cards, you can 
upgrade ours from 
1MB to 3MB at a 
later date for 
maximum flexibility. 


1 MB Upgrade £99 
3 MB Upgrade £299 
1 MB to 3 MB £200 
305 1/2 MB £89 
400 Series 1 MB £99 
400 Series 3 MB £299 


*** NEW PRODUCT *** 
A3000 BBC Analogue + User Port Podule 


Full specification BBC 
analogue and user port. 
The anelogue port is 
accessible using ADVAL 
from BASICS with all BBC 
OSbyte calls supported. 


£69 


Interface software written by Acorn for 
maximum compatibility with the BBC. 


ARCHIMEDES 
SOFTWARE 
Pipedreams £147 
RiscOs Companion £49 
1st Word + £69 
Autodesk CAD £79 


Acorn PC Emulator £99 
Acorn Desktop Pub £149 
Clares ProArtisan £145 


Clares Artisan £29 
Clares Toolkit £34 
Clares Toolkit + £43 


TELETEXT 


The Morley Teletext Adapter 
is now available for the 
Archimedes, Advanced 
specifications, including 
digital tuning, screen dumps 
etc. makes this unit ideal for 
real time date retrieval. 
Connects via the external 
podule socket or our 
Anelogue/User Port. = £125 


A3000 3.5" 
SECOND DRIVE 
4 


~Easy to install - simply plug 
in and run. 

-High quality japanese drive. 

~Includes full fitting kit and 
instructions 


Dual Drive Kit £125 


A3000 5.25" 
SECOND DRIVE 


Kit includes: 

+5,25" Teac 80 track drive 
~Casi 
-Power supply 
-Interface and leads 


£169 


NEW IN STOCK 


MICROVITEC 
A3000 
MONITOR 
£199 
INCLUDING 
CABLES 


SCSI HARD 
DISK DRIVES 


INTERFACES 
SCSI Podule £149 


3000 DISK DRIVES 
Including SCSI Podule, 
cased drive with power 
supply, cable & leads 


20MB £465 
30MB £495 
40MB £575 
60-200MB POA 


CALL FOR 300/400 PRICES 


HEE NEW HEE 
A3000 HARD DISK DRIVE UNIT 


Faster and cheaper than 
scsi. 


INTERFACE 
ST506 Podule £139 


DISK DRIVES 

Including STS06 Podule, 
cased drive with power 
supply, cable & leads 


20MB £369 
40MB £469 
60-200MB £POA 
How To Order.... 
BY POST: VAT: UK customers please add 
Enclose cheque made 15% to cost incl. carriage. 
payable to MORLEY 


ELECTRONICS LTD. 


BY PHONE: By quoting your 
ACCESS or VISA card number. 
CARRIAGE: £1 on most orders. 
£3 on larger items. Hard Disks, 
Computers + Monitors £10 
(cartier). 


GooDsS USUALLY 
DESPATCHED BY RETURN. 


Government sand Education 
orders welcome. 


Acorn & Archimedes are 
trademarks of Acorn Computers 
Ltd. 


Morlav House. West Chirtan. North Shields. Tune & Wear 


NF29 7TY. Tel (091) 957 RAB. Fax (091) 257 6373 


Into the Arc 
Making Sense of Printer Types 


by Alan Wrigley 


S. far in the Into the Arc series we have 
concentrated on the Archimedes itself and 
on the software which is supplied with it. 
We will now turn our attention to the many 
hardware devices which can be connected to 
an Archimedes, and in this first article I will 
be looking at the various types of printer 
which are available. 


A printer is normally the first item on 
the list when considering how to expand a 
basic Archimedes system. There are few 
serious uses for a computer which do not 
require some kind of printed result. 
However, choosing a printer is not as simple 
as it might appear. There is a bewildering 
array of models on the market, and to make 
matters worse there are a number of 
different types of printer, each of which 
copes better with some tasks than others, 
and each of which requires different 
software to drive it. 


PRINTER DRIVERS 

Before turning to a discussion of the 
printers themselves, it is necessary to 
introduce the concept of printer driver 
software. You cannot simply connect a 
printer to your Archimedes, press a button, 
and have everything you want printed out 
exactly as it appears on the screen. Printers 
basically understand three types of 
information: ASCII characters, bits of data 
which make up graphic images, and control 
codes which tell it how to interpret the 
information which follows. For example, 
some control codes might tell the printer to 
print everything that follows in italics, 
while others may tell it to treat the next n 
bytes as graphic data. Before printing 
anything from the computer, you need some 
kind of printer driver to send the right data 
to the printer at the right time. 


Until the advent of RISC OS and multi- 
tasking, most applications contained a built- 
in printer driver. In other words, part of the 
software was designed to interpret the 
information to be fed to the printer and 
ensure that all the correct control codes 
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were sent when necessary, followed by the 
data to be printed. However, the multi- 
tasking environment of RISC OS lends itself 
to the concept of stand-alone printer drivers 
which can be installed on the icon bar. This 
means that, as new printers come on the 
market with new facilities, it is only 
necessary to supply a new printer driver, 


instead of re-writing all existing 
applications. 
WHICH TYPE OF PRINTER? 


Printers fall basically into four types: dot 
matrix, daisywheel, ink jet and laser 
printers. Each of these uses a different 
technology, and each is better for some tasks 
than others. Acorn provides a range of RISC 
OS printer drivers which includes 
PrinterDM for dot matrix, PrinterIx for 
Integrex ink jet, PrinterLJ for HP Laserjet 
and compatibles, and PrinterPS for 
PostScript laser printers. The difference 
between these last two is explained later in 
the section on laser printers. There is 
currently no printer driver for daisywheel. 


DOT MATRIX 

This is the most common type, and has a 
column of tiny pins, usually either 9 or 24, 
in the print head. The printer’s own 
software arranges for these to strike a 
ribbon, and hence imprint tiny dots onto the 
paper, in a sequence determined by the data 
to be printed. Thus the required image is 
built up from a matrix of dots, hence the 
name. Because the ribbons are easily 
interchangeable, it is often possible to 
substitute coloured ribbons for the normal 
black, and some dot matrix printers can 
handle multi-colour printing by using a 
ribbon containing strips of different colour 
which is moved up and down in front of the 
print head according to which colour is 
required. 


In the early days of dot matrix, all 
printers were 9-pin, and few had a wide 
range of facilities; near-letter-quality print 
was unknown for example. As prices fell and 
technology improved, however, printers 
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became more sophisticated. Now it is 
possible to buy 24-pin, or even 48-pin, 
printers bristling with features such as a 
range of different fonts etc. As with all 
things, you get what you pay for, and the 
more expensive models can be expected to 
produce higher quality, have more features 
and print at a higher speed. 


Dot matrix printers are very good 
general purpose machines, and are entirely 
adequate for simple tasks such as printing 
program listings. They are also very good for 
printing text files, and many will allow you 
to select from several different fonts via the 
front panel. Generally speaking, however, 
the higher the quality of printface, the lower 
will be the speed of printing. Also, multiple 
copies of a document each take the same 
time to print, whereas with a laser printer, 
once the file has been processed and printed, 
subsequent copies can usually be produced 
much more quickly. The noise from a dot 
matrix can sometimes be objectionable, 
particularly some 24-pins which produce a 
high-pitched whine. 


When it comes to printing graphic 
images, or using a RISC OS printer driver 
on anything other than a pure text file, the 
speed drops by several orders of magnitude. 
Because each line has to be built up from 
individual dots, rather than characters 
which are already defined in the printer’s 
own ROM, it can sometimes take several 
minutes to print out such an image. This is 
acceptable for occasional use, but can be an 
enormous disadvantage when printing, say, 
multi-page documents from a DTP package. 


One phrase you will often hear in 
relation to dot matrix printers is “Epson- 
compatible”. In the early days Epson was 
the most prominent manufacturer, and the 
control codes used by its printers came to be 
accepted as an unofficial standard. This 
means that in theory, any printer claimed to 
be Epson-compatible will work correctly 
with any software making the same claim. 
In practice, there are few things in 
computing which cause as many problems 
as interfacing computers and software to 
printers, despite claims of compatibility. 
This is another powerful argument in favour 
of the RISC OS printer drivers. 


DAISYWHEEL 

Daisywheel printers are no longer as 
common as they were a few years ago, mainly 
as a result of the improvement in print 
quality of dot matrix models and the advent 
of cheap laser printers. A daisywheel uses the 
same technology as the electric typewriter on 
which it is based, namely a plastic wheel on 
which the characters are formed, which is 
then rotated and pressed against the ribbon 
to imprint the character. This results in the 
highest possible quality from a printer, since 
the characters are not composed of dots, and 
also high quality carbon ribbons can be used. 
However, it is also slow and noisy, and to 
change fonts you have to manually change 
the wheel. If you require absolute letter 
quality and do not mind the slow speed, a 
secondhand daisywheel would be worth 
considering, but bear in mind that you cannot 
use it for graphic images or for reproducing 
any of the Arc’s outline fonts, and also that 
you may have difficulty finding software 
which supports it. 


INK JET 

Ink jet printers are related to dot matrix, 
in that the image is formed from dots in 
exactly the same way, but the technology is 
very different. Instead of having pins in the 
printhead, tiny jets of ink are directed at the 
paper to build up the image. The quality 
from such printers can be very high, and the 
best of them can virtually produce laser 
quality at a significantly lower price (see the 
review of the HP DeskJet Plus in RISC User 
Volume 3 Issue 5). Another great virtue is 
the lack of noise. 


Multi-colour ink jet printers are 
available, in particular the Integrex 
Colourjet, and these have proved to be very 
popular in schools. They are capable of 
producing quite stunning colour pictures 
with suitable software. They are, however, 
more expensive to run since special paper 
impregnated with chalk is needed to get the 
best out of the printer. This is because 
normal paper absorbs the ink to a certain 
degree, and the tiny dots of colour tend to 
spread slightly, degrading the image. 


An ink jet is an excellent midway option 
between dot matrix and laser. For anyone 
who requires high quality colour printing, it 
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is probably the best option until colour laser 
printers are available at an affordable price. 
You should also consider one if you find the 
noise of a dot matrix objectionable. 
However, they can be more expensive to run 
than dot matrix printers. 


LASER PRINTERS 

A more accurate term would be “page 
printers”, since some “laser” printers do not 
use laser technology, for example liquid 
crystal printers. Nevertheless, although the 
technology may differ, the technique 
remains the same, and was described in 
detail in Introducing Laser Printers (RISC 
User Volume 3 Issue 1). For the purposes of 
this article, we shall refer to all page 
printers as laser printers. What 
distinguishes these from the other three 
types is that everything sent to the printer 
is processed on a page by page basis, as 
opposed to line by line. In other words, an 
entire page must be defined before the 
printer will print anything at all. Laser 
printers are excellent for DTP work and 
printing graphic images, while having few 
disadvantages when it comes to more 
conventional printing requirements. 


Laser printers fall broadly into two types: 
PostScript and non-PostScript. The term 
“PostScript” is in fact the name of a powerful 
computer language, known as a “page 
description language”, built into the printer. 
When printing out a page of information, 
instead of merely sending the printer a bit- 
image map of the data to be printed (i.e. 
describing each pixel in the image one at a 
time), the PostScript printer driver in fact 
sends a program to the printer. This is 
compiled from information about the image, 
fonts used and their size, and so on. The 
program is interpreted by a processor in the 
printer and converted into a printable image. 


With PostScript, fonts are held in the 
printer’s memory, either built in or 
downloaded, and the PostScript program 
matches the font on screen to the font in the 
printer. This is fine if the fonts in the 
computer are designed to have a PostScript 
equivalent, as many indeed are, including 
Acorn’s own. However, there are some fonts 
available which are not, and it may not be 
possible to print these on a PostScript 
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printer. Given the correct resources, however, 
printing a PostScript file can be significantly 
faster than using the more traditional bit- 
image route, but it does add a significant 
price premium to the printer, and also 
requires all the fonts to be held in two places. 


Non-PostScript laser printers, of which 
the HP Laserjet and its compatibles form the 
largest group, adopt the alternative 
approach, when printing a graphic image, of 
generating a complete bit map and sending 
this to the printer. This can be a lot slower 
for a single document, but does bring the 
price down. For printing in text mode, 
however, such printers normally have a 
range of built-in fonts which match or exceed 
the best dot matrix printers for quality. 


While laser printers will always be 
faster than other types, when it comes to 
printing multiple copies the difference in 
speed is even more marked. Once a page has 
been sent to the printer, it is held in the 
printer’s RAM and can be printed out any 
number of times very quickly - normally 
around 6-12 pages per minute. Laser 
printers are also very much quieter than dot 
matrix printers. Many models have an 
Epson emulation mode, too, which means 
that they can be used just like a dot matrix 
but with the advantage that the end result 
will generally be of a higher quality. 


The main disadvantages of laser printers 
are the price, bulk, and lack of colour 
capability, and as prices continue to fall, the 
first of these will become less of an obstacle. 
In addition, running costs will generally be 
higher than those for dot matrix printers. 


WHICH ONE? 

Ultimately the choice of printer rests on 
the tasks you want to perform with it and 
the price you are prepared to pay. You 
should in any event see and hear any 
printer you may be considering, since the 
specification on paper will rarely give an 
indication of the print quality or the noise 
level. The choice is vast but I hope this 
article has given you some useful guidelines. 
You can also find some useful information 
on a wide range of printers, including some 
comparison tables, on pages 44-51 of the 
latest BEEBUG Retail Catalogue. 


43 


MORE NEW RELEASES FROM DABS PRESS 


Z88 PipeDream: 
A Dabhand Guide 
from John Allen - expert Z88 journalist 


PipeDream, the builtin word processor, spread- 
sheet and database built into the Z88 is an ex- 
tremely powerful tool, and John Allen, author of 
many articles of the Z88, and experienced user 
has produced what must be the ultimate tutorial 
and reference work on the software. With many 
example documents and templates, this book 
takes you from first principles to a thorough 
understanding of the program. Linking to 
PipeDream on other machines such as the BBC 
and Archimedes is also covered. 


Only £14.95 all inclusive 
AVAILABLE 24th APRIL 


Also still available is our first book on the famous Cam- 
bridge portable marvel, Z88: A Dabhand Guide, written 
by Trinity Concepts, authors of the Z88 operating system. 
Also priced at £14.95 


THE LATEST DABHAND GUIDE 


We have moved! Please note our new address 
and telephone number for all correspondence. 


DABS PRESS (RU5) 
22 WARWICK STREET 
PRESTWICH 
MANCHESTER 

M25 7HN 

TEL: 061-773 8632 
FAX: 061-773 8290 


For personal callers Warwick St. is in the centre 
of Prestwich Village, just off Bury New Road. 


Dabs Press books and software are available 
from all good bookshops and Acorn dealers, or 
in case of difficulty direct from the above ad- 
dress. Access /Visa/ official orders accepted. Free 
catalogues on request. Prices include 15% VAT 
(on software) and UK postage. Foreign deduct 
VAT butadd £2.50 Europe/ surface, £12 airmail. 


061-773 8632 


Cambridge Pascal 
isacomprehensive 
version of the Pas- 
cal language and 
includes many ex- 
tra enhancing fea- 
tures over the stan- 
dard specification 
including full dy- 
namic string han- 
dling, local error 
handling, random 
access files, direct 
access to ‘star’ com- 
mands and RISC 
OS SWI calls. It is 
100% Desktop 
compatible but can 
also be run from the command line. All programs compile 
into fast, efficient machine code. 

Cambridge Pascal requires any Archimedes running RISC 
OS with at least IMb of RAM. Hard discs and extra 
memory are useful, but the system is perfectly workable 
with this minimum configuration. 

Price £79.95 (£69.52+VAT). Site licences available, Free 
demonstration disc and full specification sheet available 
on request. 


DEMO DISC FREE ON REQUEST 


CAMBRIDGE 
PASCAL 


Pull featured Pascal Compiler for the Acorn 
Archimedes 


ARCHIMEDES FIRST STEPS 
Beginners Guide to the 
Archimedes & BBC A3000 


This book is the perfect introductory guide to the 
Archimedes, to guide you through the first few months of 
ownership, acting as an easy-to-read supplement to the 
User Guide. 
The book describes in detail how to put the RISC OS Desk- 
top to best use, and also documents the programs on the 
Applications Discs provided with the machine. 
But the book also goes beyond this and describes the sort of 
software and hardware additions available to the 
Archimedes owner, and how to choose and install them. 
The many features of this book include: 
« Applicable to all Archimedes with RISC OS 
* Using the Desktop, RAMdisc and ADES 
Edit, Paint, Draw and Maestro 
© The Task Manager 
* The BBC and PC emulators 
* Hardware and software additions 
* Illustrated throughout 

AVAILABLE NOW! 


PRICE £9.95 
ONE OF OUR BEST SELLERS 


Improving the Picture (part 2) — 


David Spencer looks at some more monitors for the Archimedes. 


Rise User Volume 3 Issue 6 contained a 
look at three Taxan monitors - the multisync 
775 and 870, and the high resolution Viking 2. 
In this follow-up article we will look at some 
more monitors which have recently become 
available. 


THE MICROVITEC CUB3000 

The first monitor under inspection is 
neither a multisync nor a high resolution 
unit. It is instead a standard monitor 
comparable to the Acorn colour monitor and 
the Philips CM8833. I'm sure that many ex- 
model B users will feel at home as soon as 
they see the name Cub3000, as the original 
Microvitec Cub probably sold more to the 
Acorn market than all other monitors put 
together did. 


The Microvitec Cub3000 
As its name suggests, the Cub3000 is 


aimed at the A3000 market, particularly at 
education: It will however work perfectly 
well on an Archimedes. Like the original 
Cub, the Cub3000 is a very bland cube 
shape with a metal case finished in the 
same colour as the A3000 itself. A welcome 
change from the original Cub is that the 
plastic surrounding the tube is now the 
same colour as the case, whereas the earlier 
units had a dark brown surround. The tube 
is a conventional TV type - curved in both 
directions and featuring a glossy surface. A 
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Monitor 9060SZ 9070S 


Screen size(inch) 14 16 
Dot pitch (mm) 

Bandwidth (MHz) 
H Scan rate (kHz) 


0.28 0.28 
30 50 
15.5-38.5 20-50 
V Scan rate (Hz) 50-90 50-80 
Width (mm) 360 400 
Height (mm) 369 420 
Depth (mm) 411 450 
Weight (kg) 14.5 19 


Table 1. Elzo specifications 
feature that is missing is any form of 
monitor stand, meaning that the screen is 
also perfectly vertical. I found this quite 
awkward for viewing when the Cub3000 
was sat on top of an Archimedes. 


In use, the picture quality is adequate, 
but no better than that offered by the Acorn 
monitor or the CM8833. All the controls, 
which consist of a power switch, brightness, 
contrast and volume, are on the rear panel. 
A built-in speaker can be used to reproduce 
the computer's sound, but only in mono. The 
mains lead is hardwired into the monitor, 
rather than having an IEC type connector, 
and more seriously, so is the RGB video lead. 
This means that the Cub3000 is really only 
suitable for the A3000 and Archimedes, and 
couldn't be transferred to other systems. 


The Cub3000 costs more than either the 
Acorn monitor or the CM8833, and this, 
combined with its limitations, does not 
make it a very attractive buy. However, I am 
sure that some people will buy it because of 
its robustness and familiarity. 


THE EIZO FLEXSCAN RANGE 
The Flexscan range of monitors from a 
company called Eizo are all multisync units. 
The two of interest to Archimedes users are 
the 9060SZ and the 9070S. The 9060SZ is a 
low radiation 14 inch monitor, the 
specification of which is given in table 1. The 
9070S is a 16 inch model, and its specification 
is also given in table 1. A special feature of 
both these monitors is a dynamic focusing 
system which adjusts-the focus automatically 
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to give a crisp picture at all times. The 
monitors also have black and white and 
amber modes which can be selected to 
improve viewing of large amounts of text. 


The display on both the 9060 and 9070 is 
slightly superior to that of the Taxan range, 
and the monitors also appear ergonomically 
better. In particular, all the picture size and 
position controls are easily accessible on the 
front panel, but in a manner which makes 
them unobtrusive. 


The Elzo 9060S 


An interesting problem with the 9070 
(but not the 9060) is that its minimum 
horizontal scanning rate is 20kHz. This is 
higher than the 15.625kHz used by the non- 
multisyne modes, and this means that the 
monitor cannot be used in modes 0-17 or 24. 
A way around this problem is by using a 
small hardware add-on to the computer 
called a VIDC Enhancer, This increases the 
clock frequency of the VIDC chip inside the 
Archimedes, which in turn increases the 
scanning rates, Not only does this solve the 
problem, but it also allows new higher 
resolution modes to be implemented and 
reduces the flicker on existing modes. 


THE TAXAN 775 REVISITED 

The Taxan 775, which replaces the 770, 
was previewed in the previous article. This 
monitor is now readily available in its 
standard form, with a low radiation model 
expected to be launched shortly. 


In use, the 775 offers improved picture 
quality over the 770, because of its lower dot 
pitch. Unfortunately, the different scanning 


rate range offered by the 775 means that it 
is hard to set it up to obtain both a full- 
width multisyne display and a normal 
resolution display that fits on the screen. If 
the monitor is adjusted to give a usable 
mode 12 display, switching to mode 20 gives 
a display that only fills about 70% of the 
screen's width. However, the 775 will work 
with the IBM standard VGA compatible 
modes 25-28. The older 770 could never be 
adjusted to fit the whole picture on the 
screen in these modes. 


The Taxan 870 16 inch model which was 
examined last time has now been 
discontinued. Many people felt that this was 
the weakest product in the Taxan multisyne 
range, mainly because the picture quality 
was poor compared to the 770 and 775. It is 
known that Taxan are working on a 
replacement 16 inch unit, but no details 
whatsoever are available yet. 


THE TAXAN 795 

Of more interest from Taxan is the 
forthcoming Multivision 795. This is a 14 
inch monitor, like the 775, but differs in that 
it uses a Sony Trinitron tube. These tubes, 
which have been in existence for quite a 
while now, instead of having the usual three 
electron guns, one for each colour, have just 
a single gun and split the beam into three. 
This tends to give a much better, sharper 
picture, with higher quality colours. 
Another advantage is that trinitron tubes 
are cylindrical, so there is no vertical 
curvature, giving a less distorted image. 


The disadvantage of the 795 is that it 
has a minimum scanning rate of 30kHz, 
even higher than the Eizo 9070S, and 
therefore can't be used in the non-multisyne 
modes without a VIDC enhancer. However, 
this may be more than compensated for by 
its quality picture. 


The 795 will be available from July, and 


“ costs around £804 (inc. VAT). The other 


monitors are available from Beebug, priced 
as below: 


Cub3000 (0527) £247.00 
Taxan 775 (0506) £516.35 
Eizo 9060SZ (0188) £529.95 
Eizo 9070S (0187) £759.95 


All prices include VAT. RU 
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Make a Date in Your Diary 
For the 


“New Products 
“Old Favourites 
“Workshops 
“Seminars 
“Demonstrations 
*Daily Competitions 
“Free Draws 
“Fabulous Prizes 


Find us close to Victoria Station at 
The Westminster Exhibition Centre 
(Horticultural Hall) 

Elverton Street, London SW1 


=> 
Friday 7th Sept ....12 noon to 7.00pm K< ss inaascctsilon with 
Saturday 8th ........ 10am to 6.00pm le Ge BBC ACORN 
Sunday 9th ....... 10am to 6.00pm ! osen 
MAGAZINE 


Complete Range of BBC ACORN Hardware and Software 


BOOK NOW, SAVE MONEY 


For advance tickets fill in the coupon below and send with remittance to:- 
SAFESELL EXHIBITIONS 
Market House, Cross Road, Tadworth, Surrey KT20 5SR 


Advance tickets:- Adults £3.50 Under 16's £2.50 At the door:- Adults £4.00 Under 16's £3.00 
Please send ......... Adult tickets at £3.50 each. Please send ......... Under 16's tickets at £2.50 each 
Tenclose cheque / P.O. for £........ Payable to Safesell Exhibitions Ltd. 


DON'T SEND CASH !! 
PLEASE ENCLOSE A STAMPED ADDRESSED ENVELOPE 


INVESTIGATOR 
£24.95 
Investigator is a disk utility program which is 


compatible with the Archimedes series of computers 
using either RISC-OS or Arthur operating systems. 


THE SERIAL PORT 


Investigator has a fully WIMP front end and can 
perform the following on discs of many different 
formats: 


A Examine the format of a disc in detail 
« Edit the data stored on the disc 
& Make backup copies of the disc 


A Store the entire disc as an ordinary ADFS file 


“...one of the most powerful protected disc copiers 
yet published for the Archimedes...Investigator 
certainly does the job well...for peace of mind 
where valuable protected software is concerned, 
Investigator should certainly be top of your list.’ 
Micronet 


ARCTERM 
£49.95 


Arcterm is a communications terminal for the 
Archimedes providing unparalleled flexibility and 
speed in the field of Archimedes terminal software. 


’... Arcterm’s viewdata mode certainly looks the 
best ... Arcterm is one of the most comprehensive 
terminal packages around for any machine, let 
alone the Archimedes.’ 

Micronet 


To purchase a Serial Port production either order 
direct from us at the address below (you can pay 
using Access, Visa, American Express or cheque), or 
contact your local dealer. If they don’t have it, tell 
them to give us a call! 


THE SERIAL PORT 
Burcott Manor, Wells, Somerset BA 5 1NH 
Phone 0243 531194 Fax 0243 531196 


by Lee Calcraft 


THE WIMP MENU SYSTEM 

Of the four major features of the Wimp 
system, as expressed in the acronym 
itself, we come now to the last. Having 
given some exposure to Windows, Icons 
and Pointers (the latter by implication), it 
is finally the turn of Menus. 


Menus are handled by the Archimedes 
Wimp in a manner consistent with other 
aspects of the system, and if you have 
followed this series up to now, the 
following should have a familiar feel to it. 
Broadly speaking, menus are generated by 
calling Wimp_CreateMenu (SWI &400D4). 
This call requires a large parameter block 
to specify all the relevant data, including 
the text (or sprite) for each menu item, 
whether an entry is ticked, whether it has 
a right arrow indicating further options (or 
windows), the colours to be used and so on. 


Implementing a three-option menu 


Unlike this call’s window-creating 
counterpart (i.e. Wimp_CreateWindow), 
Wimp_CreateMenu actually puts the menu 
on the screen, and handles all actions of 
the user. Thus if the user clicks outside the 
menu area, the menu will be removed, 
while if he selects an item, the Wimp will 
inform the task through the Wimp Poll 
using the new reason code 9. The task can 
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Part 10: Menus 


then just check the parameter block 
returned by the Wimp to find out which 
selections the user has made. 


INSTALLING A MENU IN THE 
EXAMPLE PROGRAM 

The best way to see how the menu 
system works is to look at a real example. 
We will again take the tried and tested 
program from part 1 of the series. I will 
assume that you have modified it as the 
series has progressed, and that it is in a 
state similar to that achieved by the end 
of part 9, and that it has been renumbered 
using: 

RENUMBER 
This should make the last line number 
1420. If not, do not worry too much, it will 
still be easy to implement the menu code. 
The only real necessity is that you should 
have included the icon code from parts 7-9 
of the series, and in particular the icon 
with the handle i4handle% (plus the 
definition of FNicon from part 7). This is 
the icon which sits on the icon bar. 


The first change to the test program is 
to remove the debugging code used in the 
Wimp Poll routine. This just involves 
altering the line which begins WHEN 8 
(around line 560) to read as follows: 

WHEN 8:SYS "Wimp ProcessKey", block%!24 


Next we must defer opening the task’s 
main window until the user has clicked on 
the icon bar icon. To do this we need to 
move the code headed OPEN WINDOW 
(lines 310-360 on the renumbered version) 
to the end of the program, and place it 
within a procedure thus: 


DEFPROCopenwindow 

block’ !0=whandles 

SYS "Wimp GetWindowState", , block’ 
SYS "Wimp OpenWindow", , block’ 
ENDPROC 


Now we must alter what happens in 
response to Wimp_Poll reason code 6 - a 
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loop (at line 550 in the renumbered 

program) which begins WHEN 6 to read: 
WHEN 6:PROCbuttons 

And append the following procedure 

definition to the end of the program: 


DEFPROCbuttons 
x%=!block%:y%=block$!4 
CASE TRUE OF 
WHEN block$!12=-2 
IF block%!8 AND 2 THEN 
PROCdrawmenu (menu, "Menu tester, 
Info, Save, Quit", x%, y%, TRUE) 
ELSE IF block%!8 AND 5 THEN PROCop 
enwindow 
ENDIF 
WHEN block%!16=ihandle%:SOUND 1,-15, 
70,4 
ENDCASE 
ENDPROC 


The purpose of this is to respond to 
three different button presses: 

Clicking Menu over the icon on the 
icon bar 

Clicking Select over the icon on the 
icon bar 

Clicking Select (or Adjust) over the 
icon in the test window. 


These responses are decoded as 
follows. block%!12 (returned by the Wimp 
Poll with reason code 6) holds the handle 
of the window over which the button was 
clicked, or -2 if the user clicked over the 
icon bar. There is only one icon on the icon 
bar owned by our task, so if block%!12 is -2 
then the user has clicked over it. 


We now check block%!8 to see which 
button was pressed. If it was the Menu 
button we call PROCdrawmenu (see later), 
while if it was Select we open the task’s 
window by calling the new procedure 
PROCopenwindow. Alternatively if 
block%!16 contains the handle of icon 
number one, a beep is sounded (for no 
better reason than to indicate how to 
respond to clicking over icons within a 
normal task window). Note of course, that 
until the task’s window has been opened 


button press. Alter the line in the Wimp_Poll 


by clicking on the icon bar icon, this latter 
selection is physically impossible. 


At this point, you should append the 
definition of PROCdrawmenu to the 
program (see listing 1), and alter line 90 
as follows, to dimension a block of memory 
at menu% for use by the menu: 

90 DIM block% &200,text1% &20,menu% &1 
00 
Note that you need a separate block of 
memory for this purpose because the data 
which it contains must remain intact for 
the whole time that the menu is open. 


The sole purpose of PROCdrawmenu is 
to set up an appropriate parameter block 
and then call Wimp_CreateMenu. The 
definition of this block appears in table 1. 
The procedure falls into two sections, The 
first sets up the data for the first 28 bytes 
of the parameter block, controlling general 
aspects of the menu. The second uses a 
WHILE loop to set up the individual 
characteristics of each of the menu entries 
in turn, 


In the first part of the procedure, we 
have set up the foreground and background 
colours of the menu, and a menu width of 
140 graphics units. The height of each 
menu entry is set at 44 following Acorn’s 
guidelines. The WHILE loop, which 
handles the individual menu entries is 
controlled by the string passed to the 
procedure (Test task,Info,Save, Quit), This 
contains the name of the title of the menu 
(usually the name of the application itself, 
and without the addition of the word 
“Menu”) followed by the name of each 
menu entry, using comma separators. The 
maximum length of the name of any item is 
12 characters, and Acorn’s guidelines 
suggest that each entry should be in lower 
case except for an initial capital letter. 
‘Bytes 0-3 are set to zero, indicating that 
there should be no ticks ete. Bytes 4-7 are 
set to -1 indicating that there is no sub- 
menu, while the icon flags at bytes 8-11 are 
set to &7000021. This informs the Wimp 
that the icon which makes up each menu 
entry is a text icon with a filled background 
with foreground colour 7 and background 0. 
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Ri =-1 means close any active menu, or 

Ri = pointer to menu block 

R2 = x coord of top-left of top level menu 

R3 = y coord of top-left of top level menu 

R2 and R3 use operating system co-ordinates 


R1+0 menu title (or null string) 
Ri+12_ title foreground & frame colour 
R1+13 title background colour 
Ri+14 menu work area foreground colour 
R1+15 menu work area background colour 
R1+16 width of menu 
R1+20 height of each menu entry 
R1+24 vertical gap between items 
R1+28 menu items as follows 

(24 bytes each) 


bytes 0-3 
Bit Meaning when set 

display tick to left of item 
dashed underline to separate item 
item is writeable 
generate message when moving to sub-menu 
this is last item in menu 

all others must be zero 


bytes 4-7 

sub-menu pointer (>=&8000) or 

window handle (1-&7FFF) (-1 if none) 
bytes 8-11 

menu icon flags (as for normal icon) 
bytes 12-23 

menu icon data (as for normal icon) 


Table 1. The parameter block supplied when 
calling SYS Wimp_CreateWindow 


In our example each menu item is a 
piece of plain text in the system font, and 
this is supplied at bytes 12-23 for each 
menu item - though like ordinary icons, 
they could just as well be in an outline 
font, or be a sprite, or use indirection 
techniques to specify validation strings 
etc., or even be writeable. 


The purpose of line 1810 in the program 


just after the end of the WHILE loop is to . 


set bit 7 of the word at byte zero of the last 
menu entry to mark it as such. Finally 
Wimp_CreateMenu is called, which puts 
the menu on the screen. Note here the the 
parameters supplied in R2 and R3 (the top 
left co-ordinates of the menu). These are 
derived from the co-ordinates of the mouse 
pointer when the Menu button was pressed 


(passed to PROCdrawmenu as the 
parameters x% and y%). You will see that 
the y co-ordinate of the menu is made 
dependent on the parameter oniconbar%. 
This is because the Acorn guidelines 
suggest that icon bar menus should appear 
96 OS units from the bottom of the screen. 


Once SYS Wimp_CreateMenu has put 
the menu on the screen, the task can leave 
the handling of the menu entirely up to the 
Wimp until it returns a reason code of 9 in 
the Wimp Poll. This informs the task that a 
selection has been made from its menu. 


The Wimp_Poll 
Menu_Selection Event 

So far we have added to the test 
program all the code necessary for 
creating a 3 option menu. But our 
application will not yet respond to 
selections made by the user. To make this 
happen, we need to insert an additional 
line into the Wimp Poll CASE statement 
in the definition of PROCpoll (around line 
570 in the renumbered version of the 
program). Insert the following line 
without overwriting any others: 

WHEN 9:PROCmenuselect 
Then add the following new procedure to 


the end of the program: 
DEFPROCmenuselect 
choice%=!block’ 
vDU 4 
PRINT TAB(0,0)"Menu selection ";choice 
%;SPC2 
vou 5 
IF choice%=2 THEN quit%=TRUE 
ENDPROC 


This reads the number of the menu entry 
selected by the user, as returned by the 
Wimp. 


The actual parameter block returned 
with reason code 9 is as follows: 


R1+0 item in main menu which was 
selected (starting from 0) 

R1+4 item in first sub-menu which 
was selected 

R1+8 item in second sub-menu which 
was selected 

etc. 
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x1 ARM3 UPGRADE @&® 


Aleph One Limited Aleph One Limited 


The Aleph One Limited ARM3 Upgrade propels the Acorn Archimedes range to give 
a phenomenal 10-12 MIPS (Million Instructions per Second). Acorn Computers’ own 
VLSI Design Team has engineered this latest ARM processor to give performance 
on a par with top class workstations - based on the same ARM2 processor core 
already used in the Archimedes, ARMS is machine-code compatible yet typically 
runs THREE times faster! Here's what some ARMS users and reviewers have had 
to say... 


"Really, it is not a question of whether you can afford to upgrade, you should 
ask yourself if you can afford not to!" 
Paul Fellows, A&B Computing. 
"Time is money. You value your time, you buy the product." 


Roger Howarth, BBC Acorn User. 
"Our 1024-point fast Fourier transforms used to take about 150ms; now we 
can do them in S0ms, so we see them in real time." 
A user in the MoD. 
"I am writing to congratulate you on your excellent ARM3 Upgrade..." 


Dr. Colin Dean, Cambridge. 


"The overall speed improvement was no less than 12.6 times - avery 
significant increase - and produced [1 to 300 terms in I second." 


Mr G H Foot, Oxted. 
"...an Archimedes fitted with an ARM3 is still an inexpensive way to buy the 
15 to 20 MIPS it offers on many programs." 
Dick Pountain, BYTE Magazine. 


When running the C Dhrystone benchmark from the Desktop in mode 12 the ARM 
cache improves the performance from 4630 to 15480 dhrystones per second, a ratic 
of 3.4, Many BASIC or machine code programs will be sped up more than this - the 
improvement is highly dependent on the task’ being done and the screen mode. For 
detailed information on performance please write or ‘phone us. 

The fine print... Two speeds of ARM3 Upgrade are available, with clock rates of 20MHz and 30MHz. A 30MHz 
upgrade costs £595 + VAT (RRP). The 20MHz upgrade costs £495 +VAT (RRP). The 20MHz upgrade is only sold 
direct from Aleph One Ltd. - please call for availability. The Upgrade can be fitted to A810 & A440 models with the 


addition of a MEMCta upgrade, and directly to A410, A420, A440/1 and R140 models. Available from all good 
dealers or directly from us. 


For details contact: 
Aleph One Ltd. The Old Courthouse, Bottisham, CAMBRIDGE, CB5 9BA. 
Telephone (0223) 811679 Facsimile (0223) 812713 
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This list is terminated by an entry of -1, 
and since our menu currently has no sub- 
menus, we need look no further than 
R1+0 to determine the user’s selection. 
The program stores this in choice%. The 
PRINT statement and the surrounding 
VDU 4 and 5 constitute a debugging 
device, and serve to display at the top 
left-hand corner of the Desktop the menu 
choice made by the user. The only choice 
which is responded to in this example 
is choice 2 Quit. This just sets 
quit%=TRUE, which results in termination 
of the task. 


If you now run the test program by 
double-clicking on its icon in a directory 
viewer, it should install itself on the icon 
bar. Clicking with Select on this icon 
should open the task’s window, while 
clicking Menu will bring up our test menu. 
If you make selections from this, you 
should see a number representing your 
choice displayed at the top left of the 
screen. Clicking on Quit will close down 
the task and remove the task’s icon from 
the icon bar. At the moment, whether you 
make selections with the Select of Adjust 
buttons, the menu will disappear from the 
screen after the selection has been made. 
We will look into how to keep the menu 
active after Adjust selections (as required 
by Wimp guidelines) next month. 


When running the test program, you 
may have noticed that clicking on the 
Close icon of the task’s window closes the 
task down completely. This feature is a 
throwback from earlier versions of the test 
program which did not run from the icon 
bar. To make the Close icon close the 
application window without closing down 
the task, simply replace the line in the 
Wimp Poll (line 540 approx) which reads: 

WHEN 3:quit%=TRUE 
with: 

WHEN 3:!block%=whandle%:SYS "Wimp Clos 
eWindow", , block’ 
This uses the new SYS call Wimp_CloseWindow 
to remove the window. It takes just one 
parameter: R1, and this should contain a 
block of memory containing just one word 


at block%: viz. the handle of the window 
to be closed. 


It may be worth experimenting with 
the program at this stage. Try altering the 
menu’s menu flags so that some of the 
entries are ticked, or have dashed lines 
beneath them (the purpose of these is to 
divide a menu into sections), You may also 
like to alter the number of items in the 
menu, and to implement a CASE 
statement in PROCmenuselect which 
performs different actions depending on 
which selections have been made from the 
menu. 


Next month we will look at the 
implementation of extensions of this 
simple menu to include Info boxes, Save 
boxes and sub-menus. 


Listing 1 
1630 DEFPROCdrawmenu (mt, menu$, x%, y%, oni 


conbar$) 

1640 menu$?12=7 :menu$?13=2 

1650 menu$?14=7 :menu$?15=0 

1660 menu%!16=140:menu$!20=44 

1670 menu$!24=0:ptr%=menus+28 

1680 $menu%=LEFTS$ (menu$, INSTR(menu$,"," 
)-1) 

1690 menu$+="," 

1700 entries%=0 

1710 WHILE menu$<>"" 


1720  menu$=MID$ (menu$, INSTR(menu$,"," 
)+1) 

1730 IF menu$<>"" THEN 

1740 !ptrt=0:ptr¢!4=-1 

1750 ptr%!8=47000021 

1760 $(ptr%+12) =LEFT$ (menu$, INSTR (m 
enu$,",")-1) 

1770 ptr$+=24 

1780 entries$+=1 

1790 ENDIF 


1800 ENDWHILE 

1810 ptr$!-24=ptr%!-24 OR &80:REM mark 
item as last 

1820 IF oniconbar$ THEN ypos%=96+entrie 
s%*44 ELSE ypos%=y%+20 

1830 SYS "Wimp CreateMenu", ,menu%, x%-64 
rYpos’ 

1840 ENDPROC AU 
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SCAN-LIGHT 3000 BRS --- 
-an-Light 3000 is the only scanner designed 
pecifically for the Archimedes A300, 

The package consists of an internally fitting 

expansion board, power supply, software on 

board and a 400 dpi hand-held scanner, 


Since the fully RISC OS compatible software is 
| | supplied in ROM on the expansion board, it can 
be started without the need to load anything from 


disc - it is always instantly available. The soft- 
ware is simple to use and has many advanced 
features; « Choice of monochrome or grey-scale 
scans + Scan resolutions of 100, 200, 300 or 400 
dpi. * Unique grey-map control allowing total 
control over the brightness and contrast after the 
picture has been scanned (there is also a bright- 
ness control on the scanner), This even allows 


pictures to be inverted (you can scan photo- 
| | graphic negatives) « Image manipulation facilities 
for picture smoothing and enhancement + Integra- 
tion with other RISC OS applications allowing 


pictures to be transferred directly to other Jp : 
programs, such as Paint, Draw, Impression etc z z 
The Archimedes is a computer that can handle 
both graphics and text with equal ease, and Scan- 
Light is the best way to obtain pictures for the 


computer - ideal for capturing photographs, 
artwork or graphics of any sort. 


£189.00 + VAT (£217.35 incl.) 


Computer Concepts Ltd 


Gaddesden Place, Hemel Hempstead, Herts. 
HP2 6EX. Tel (0442) 63933 Fax (0442) 231632 


 LaserDirect consists of an 
interface board, our RISC OS printer 
driver software, and a special 
version of the 300 dpi Qume six page per 
minute printer, Because the board drives the 
printer ‘engine’ directly, not only does this save a complex 
controller board usually resident in the printer, but it also means 
it prints very much faster than traditional printers. The speed is 
a combined result of our optimised RISC OS printer driver, the 
RISC processor and the unique 2Mbit/second data link to the 
printer. One other significant advantage is that the LaserDirect 
uses the Acorn outline fonts installed in the machine, so 
guaranteeing all fonts seen on screen will print - no need to 
make sure the fonts match those installed in your PostScript 
printer. 


THE 

ARCHIMEDES it is 
LASER 

PRINTER 


Special features - Software on board means 
always available and can be 
automatically installed on startup - no 
loading from disc + The LaserDirect offers 
special links to other Computer Concepts 
software. For example, when combined with the new Scan- 
Light Plus software, it offers a direct scan to print facility. It can 
scan and print a full A4 page in under a minute. * A PostScript 
compatible interpreter will also be available, turning the 
Archimedes and LaserDirect printer into a very fast PostScript 
compatble printer (but using the Acorn outline fonts). 


LaserDirect Qume (incl. printer, interface board, and software) 
£999 +VAT & carriage 


The result is a printer whose 
quality is the same or better 
than traditional lasers, that can 
use all RISC OS outline fonts, 
that is faster than traditional 
printers, and costs less. 


The Qume Liquid Crystal Printer is not technically a laser 
printer. Instead of having a laser and spinning mirror 
arrangement, this printer has a conventional light source 
shining through a liquid crystal shutter array. The result is 
fewer moving parts, a lower cost and a more reliable printer. It 
also occupies a very small amount of desk space - 42cm by 
42cm, no more than a standard dot-matrix. 


PERFORMANCE TESTS 


Test 1 - A complex page of text and graphics from Acorn Desktop Publisher 
Test 2 - The same test page from Impression 
Test 3 - A 10 page text document from Impression 


LaserDirect 


Compatible with all 
applications that use RISC OS 
printer drivers, e.g. Draw, 
Paint, Pipedream, ADP, 
Impression etc. 


requires a 


minimum of 2Mbytes of RAM in 
the Archimedes. However, the more 
memory available the better the 


testis were 


test1 test2  test3 RRP 
Typical PostScript || 1203s || 513s |[ 416s || £3000|  ["* 
[Typical LaserJet || 5'35s |/ 429s || 3135s || £1400) ™ mae The iv 
rc tlormed on an machine 
[ LaserDirect Qume || 243s |{ 100s || 429s |[ £999 |. @ i 


(2Mbytes RAM) with hard disc. All 
times in minutes and seconds, 


Computer Concepts Ltd 


Gaddesden Place, Hemel Hempstead, Herts. HP2 6EX. Tel (0442) 63933 Fax (0442) 231632 
‘The above details are subject to change. All trademarks are acknowledged. 
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VDU4 NEWLINE 
Alan Wrigley 
When typing or editing text or programs in 
VDU4 mode, on reaching the end of the line 
the cursor does not immediately move to the 
start of the next line, but stays over the last 
character typed. A “pending newline” is 
flagged, but not activated until the next 
character is entered. This can be a little 
confusing within an editor if you are used to 
the more normal situation where a new line is 
generated immediately. However, you can turn 
the effect off with the following command: 
VDU 23,16,0,254,0;0;0; 
and turn it back on again with: 
VDU 23,16,1,254,0;0;0; 


SPRITES AND FORMED 

David Spencer 
When using Acorn's window template editor, 
FormEd, it can normally only display the 
standard set of sprites held in the RISC OS 
ROM. For example, if you are designing a save 
box to save draw files, the draw file icon would 
not appear within FormEd, as the sprite 
(file_aff) is not in the ROM. Luckily, though, 
FormEd allows new sprites to be merged in by 
dragging a sprite file onto the FormEd icon on 
the icon bar. So. for example, dragging the 
!Sprites file from Draw onto FormEd will make 
the Draw file sprite visible. 


MORE SPRITES AND FORMED 

David Spencer 
The current version of FormEd doesn't allow 
indirected sprite-only icons to be defined. 
Typically, these are used to allow an icon's sprite 
to be in a different sprite area from that defined 
in the parent window. What's more, if you try to 
read a template containing such a definition into 
FormEd then the application crashes rather 
messily, The solution to this is to patch the icon 
definition after it has been read from the 
template file by SWI "Wimp_LoadTemplate”, but 
before calling SWI "Wimp_CreateWindow". 


YET MORE ABOUT FORMED 

David Spencer 
A minor, but important, point to note about 
templates created using FormEd is that the 
window will be created in the same position on 
the screen as it was in the editor. For example, 
if you create a window in the bottom left-hand 
corner and behind all other windows, then 
loading the template, defining and opening 
that window will cause it to be opened in 
exactly the same place. The solution is to again 
patch the template definition before opening 
the window, or to ignore the existing position 
when using SWI "Wimp_OpenWindow". 
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PAGE, HIMEM AND END 
Alan Wrigley 


The Basic variables PAGE, HIMEM and END 
can give some useful information about the 
program environment. PAGE under RISC OS 
is, by default, &8F00. However, you should not 
assume that this is always the case. Future 
versions of the operating system may use a 
different value. Also, it is theoretically possible 
for an application to alter the value of PAGE, 
though unlike the BBC micro environment, 
there is little reason to do so. 


HIMEM gives the upper limit of the application 
workspace, in this case the space allocated to 
Basic when the language is entered. The 
maximum amount of memory normally allocated 
to Basic is 640K, which results in HIMEM being 
&A8000. However, this may be lower if other 
applications have already claimed workspace, or 
indeed you can make it higher if sufficient 
memory is available by using the Task Manager 
to increase the Next slot before entering Basic. 


END is a very useful variable which performs a 
function not easily achieved on the old BBC 
micro (but it must not be confused with the 
statement END which terminates the execution 
of a program). END returns the address of the 
end of Basic variables in memory, i.e. the lowest 
spare location. What makes END even more 
useful is that you can also use it to set the 
highest address used by Basic. So you can 
increase or shrink the application workspace, 
e.g. END=&A000 or END=&B0000. This can be 
used within a program to dynamically allocate 
more memory for the task. 


FONT PROBLEMS 


Chris Parker 


David Pilling’s hint in RISC User Volume 3 
Issue 4 stated that Edit would crash with more 
than 12 fonts installed. A simple but inelegant 
solution to this is to insert the following line 
into Edit’s !Run file: 
Unset Font$Prefix 

then double-click on !Fonts after loading Edit 
but before running any other applications that 
require outline fonts. 


It appears, too, that Draw is designed to run 
with a maximum of 64 fonts. As a result, I 
restrict my !Fonts application to about 60, and 
swap fonts over as required. 


Data Store's FontFX also has difficulty coping 
with large numbers of fonts. The variables 
fontlist% and fontmenu% (to be found within 
PROCInitialise_Variables in the application's 
!RunImage file) should be dimensioned to at 
least &1000. 
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However, Impression copes perfectly with the 
127 Fonts that I now have. 


FINDING PATHNAMES 
David Spencer 
When writing a Desktop application that can 
load and save files, you often need to find just 
the leafname (filename) given a full pathname. 
For example, the leafname of: 
adfs::Winnie.$.Applics.DataFiles.Letter 
is ‘Letter’. 
The following short function does just that - 
taking a full pathname and returning just the 
leafname. It works by ‘peeling off elements of 
the pathname until only the leafname remains. 
1000 DEF FNleaf (path$) 
1010 WHILE INSTR (path$,".") 
1020 path$=MID$ (path$, INSTR (path$,".")+1) 
1030 ENDWHILE 
1040 =path$ 


As it stands, the routine is only guaranteed to 
work with full pathnames. It cannot handle 
pathnames such as: 

adfs::blob 


Napoleonic Battle Simulator 


Refight famous historical battles of the Napoleonic era. 
Become the commander in the field and direct vast 
armies of infantry, cavalry and artillery. 


* Mult+tasks in the Desktop environment. 
* Two players or one player agairist the computer. 


* Two historical scenarios - Waterloo and Maida. 
Each scenario includes the regiments involved on 
a scale map of the battlefield. 


* Features include play-by-mail option, zoom in / out 
map, status details, four complexity levels, timer. 


* Comprehensive rule booklet covering movement, 
combat, visibility and morale, 


Send a cheque for £15-95 payable to Spearpoint or 
SAE for further information to 

Spearpoint 

3, Lawrence Crescent, 

Edgware, 

Middx, HA8 SPB. 
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where no ‘.' is present in the line. This isn't a 
major problem, though, as only full pathnames 
should appear in a Desktop application. 


BASIC EDITOR 
Mike lronmonger 

Typing EDIT from within Basic to enter the 
Basic editor actually executes the command 
*ARMBE. When the editor module is present 
it recognises this and starts up the editor. If 
it is not present, however, the filing system 
tries to execute the file ARMBE. You can 
take advantage of this by creating an Obey 
file called ARMBE in the library directory 
which will load and enter the editor, as 
follows: 

RMLoad <filepath>.BasicEdit 

PX21 

Key0 EDIT|M 

FX138, 0,128 
The first line loads the module, and <filepath> 
must contain the pathname depending on 
where the module is located. The second line 
clears the keyboard buffer and the remaining 
instructions insert the command EDIT into the 
buffer. RU 


Home & Business Programs 
from Apricote Studios 


The Account Book 
Comprehensive small business accounts to trial balance, 
VAT approved. Absolutely the easiest program to use, with 
neat final books and hundreds of reports. No entry limits, 
"The Account Book gets first prize for both price and 
|performance"- comparison of different business programs in| 
Micro User-July '89. "A true user-friendly program. If you 
buy these packages you will not be disappointed'"-Beebug- 
Oct '88 & Dec '89. Just £27.95. 
The Invoice 
Link with The Account Book or use independently. 700 
customer database, Invoices, Statements, Stock presets, 
Debtor lists, Mail shot labels and loads more. £27.95. 
Purchase The Account Book and The Invoice Program 
together for £49.95. 


Personal Accounts 
10 on-line accounts, 48 income/payment headings, 20 direct 
debits. Scrolling entries with the best edit, search and 
reporting facilities. $14.95. Full refund if you don't agree. 
‘Cambs 


Apricote Studios 
A os = 


2 Purls Bridge Farm 
‘Tel: 035 478 432 for information, help or to order. 


Manea 


ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


If you have written any programs, completed or not, then we would like 
to hear from you. 


If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in, 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


If you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become pant of the leading software team producing 
software for the worlds fastest micro. 


J _T_lll_ott____H_!____| 


Postbag = 


PRESENTER II FROM LINGENUITY 


I would like to comment on Mike Williams’ 
review of Presenter II in RISC User Volume 3 
Issue 4. He remarks that there is no way of 
directly creating an empty data entry sheet; 
there is - you simply click with Select on the 
Presenter II icon and a new data entry sheet 
appears on the screen. 

Peter Barlow 


| can recall trying all sorts of things to achieve 
this at the time of the review, but | clearly 
overlooked the most obvious. | could not find 
this information in the manual either. 


ARCHIMEDES THEFT 


I would like to inform you that my A310 
system was stolen today. The details are as 
follows: 


A310 (serial number 27-AKB15-1000816) 
with Watford I/O controller, BEEBUG 
40Mbyte drive (Ser. No. 20052), Computer 
Concepts ROM/RAM podule, Watford 5.25” 
disc buffer, Cannon 5.25” drive, Acorn colour 
monitor (28-AKF11-1001998) and Star LC- 
10 printer (313080772520 I think). 


Yours depressed, 
Martin Platts, Birmingham. 


We will pass on to Mr.Platts any information 
which we receive. It may also be opportune to 
remind readers of the desirability of checking 
that their computer system is adequately 
covered by household insurance, and that 
reasonable attention is given to security 
aspects. 


APPLICATION SHELL GENERATOR 


There appears to be a slight problem with the 
Application Shell Generator (see RISC 
User Volume 3 Issue 5). The generated sprites 
are defined as 35 by 18 units rather than the 
more normal 34 by 17 units. To adopt the 
standard size, change the program as 
follows: 

840 RECTANGLE FILL 190,320, 67, 67 

860 RECTANGLE 190,320, 67,67 

1200 MOVE 190,320:MOVE BY 67,67 

and add: 

205 GCOL bor:RECTANGLE 190,320, 67,67 

David Carr 
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Mr.Carr is right in what he says, in that by 
convention most RISC OS sprites are 34 by 17 
units in size. However, RISC OS can and does 
use sprites which are larger than this, and the 
program will function quite happily with the 
slightly larger size. 


RECOVERING LOST FILES WITH 
TOOLBOX 


I would like your advice on the use of the 
RISC OS Toolbox. What are the steps needed 
to recover lost files? 

B.S.Hudson 


To recover any file from disc you need a disc 
sector editor such as that contained in Toolbox 
to locate the file on disc. Use this to determine 
the disc address of the first sector containing 
the file, and the size of the file (in bytes), by 
browsing through the disc sectors and 
examining each in turn. Now, from Basic, read 
the sectors of the file into memory using SYS 
“ADFS_DiscOp”. The syntax is: 


SYS "ADFS DiscOp", ,1,<disc address>, 
<address>,<file size> 


where <disc address> is the address of the 
first sector as determined above, <address> is 
the start address in memory where the sectors 
are to be stored (we suggest &9000), and <file 
size> is the size of the file in bytes rounded up 
to the nearest multiple of 1024. Then save the 
file back to disc using “SAVE <file name> (see 
the User Guide for more details of this 
command). 


Note that with ‘E’ format discs, a file may be 
spread over different areas of the disc. It will 
then be necessary to locate all of these 
segments and read them into contiguous areas 
of memory using multiple calls to SYS 
“ADFS_DiscOp”. 


FOOTNOTE 


Further to Mr.Masefield’s letter in the April issue 
(Volume 3 Issue 5), the effect of restricted 
pointer movement referred to (in mode 16) 
appears to be more a function of RISC OS than 
it is of the application. In these circumstances, 
dragging any available window to the right of 
the screen appears then to free the pointer so 
that its movement is then unrestricted. RU 
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PIPEDREAM 3 


8/8] PipeDrean: adfs::a448wini.$.pd.ExanplesPD .AdSS iT 
in {2} 
1 Car Lovers Annual Report on Company Fleet 

2 Value Value % 

3 year ago row Cpety Cyls Reg. 

4 Porsche CarreraRSL £50,060 £150,000 2700 «6 —«RS27 

5 AC Cobra 289 Mk IT £90,000 £150,000 470 & 289 COB 

§ Jaguar D type £375,000 £950.00 6 DI 

2? Feirati 250 SWB £500,000 £1,100,000 12 SWB 250 
Viet £35,000 £60,000 8 GTB 308 

iW ‘Comment Fleet values 

12 As you can see from 1 

13 the graph on the right — 1000} D Valve year ago 

14 hand side. the Car Value now 

15) Lovers investment in "Appreciation 

16 superb classic cars has 

1? performed —outstand- 

18 ingl). outstripping 

19 most conventional 

it forms of investment. 

22 The outlook remains 

23> wsy, with =more 

nH investment — funds 0 = : 

SU towing soto” ee Rivehe RS ACGobea laguer 0 Fertan SWE Ferrati 308 

26 market. v 


PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 

Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3. Itis fully multi-tasking and multi-windowing, so you can workon many documentsat once and instantly 
move information between them, And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 


Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers. 
For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 


Major features include: 


* many documents loaded at once + automatic loading of VIEW, 


* intuitive RISC OS user interface ViewSheet, Lotus, First Word _) For a free brochure, complete and retum this coupon 

* displaying and printing Plus, Tab and CSV files IPipeDream 3 0) View Professional CI | 
of pictures within text * automatic saving of VIEW, [Name | 

+ built-in 93,003 word Lotus, Acorn DTP format, Tab | Address | 
spelling checker and CSV files 

* file compatibility with + multi-field sorting | | 
PC & 288 PipeDream and * use of all available fonts | Post code | 
BBC View Professional * 62 spreadsheet functions 

* background recalculation * external references for 3-D | Cotton Software, Broadway House,149-151 St. Neots| 

* keystroke compatibility modelling Read, Hardwick, Cambridge CB3 7QJ, England. | 
with Z88 & PC PipeDream * macro file recorder Fax: 0954 211607 Tel: 0954 211472 

* 288 filing system e sionpromaon, il 


All trademarks acknowledged. The chart in the screen shown above was produced by sending numbers from PipeDream 3 to Lingenuity’s Presenter 2and then loading the resulting graph 
‘back into PipeDrezm 3 


Colton Software, Broadway House, 149-151 St. Neots Road, Hardwick, Cambridge, CB3 7QJ, England. 
Fax. 0954 211607 Tel. 0954 211472 


Technical Queries 


USING *FX3 FOR OUTPUT 

Dear Sir, 

In RISC. User Volume 3 Issue 2 there Is a 
note on printing with VDU2 and *FX3. 
*FX3,10 which avolds any need for VDU2 
by sending all further output only to the 
printer, is so useful that | was surprised 
to find It omitted, and from both editions 
of the User Gulde. The second edition 
Implies that there are better RISC OS 
replacements for most *FX commands. | 
would like to know how they replace *FX3. 


There Is a snag with using *FX3,10 which 
| have been unable to explain. Can you 
help? If | use VDU2 and key In all those 
tedious 1's everything works correctly. If 
l use *FX3,10 there can be snags. 
D.M.McDowell 


*FX3,10 is very useful, but it suffers from 
one drawback, which is causing your 
problem. When using VDU2 to output to the 
printer, any single character immediately 
following a ‘1’ is sent regardless. However, 
when using *FX3,10 to print, the currently 
configured printer ignore character is taken 
into account, and that character is not sent 
to the printer. This is often set to 10 to 
ignore line feeds, but this means that every 
occurrence of code 10 is ignored. 


If your Archimedes is configured to Noignore 
status, or if you type *Noignore at the 
command line before running a program, 
then everything will get through to the 
printer correctly, though you would need to 
reset the printer’s dip switch to avoid line 
feeds. Even with this setting, if a previous 
program has used *FX6 this will override any 
configured setting until the next hard Break. 


Unless you know exactly what your program 
outputs there is no easy way to satisfy all 
requirements. If character 10 is set to be 
ignored, you could trap, say, any margin 
settings or downloaded characters by using a 
statement such as: 
IF A%=10 VDU FNten ELSE VDU A% 

and include in the program a function FNten 
such as: 


With regard to the replacement of *FX3 by a 
RISC OS command, I imagine that Acorn’s 
intention is that all output should use the 
RISC OS printer drivers, and that the older 
style of commands would become obsolete. To 
my knowledge, there is no direct replacement 
for *FX3 as such. 

Alan Wrigley 


FINDING BASIC PROGRAMS 


Dear Sir, 
lam puzzled about the RISC User discs. | 
understood that | would be able to list 
any of the programs (e.g. Wimp4) from 
the disc so that | might be able to edit 
them and see what difference the 
alterations make - as suggested. However, 
! have been unable to list a program, 
although | have been able to run them. 
Can you please help? 

E.Twigg 


There is no problem with listing any 
program on a RISC User magazine disc, but 
you do have to find it first. When you open 
the directory viewer for a RISC User disc, 
you will see the !RU... application directory. 
The ‘! character signifies that this is an 
application directory, not an ordinary one, 
and therefore runs the application in 
response to double-clicking, 


In order to open an application directory, you 
must double-click on its icon while holding 
down the Shift key. Doing this with !RU... 
will reveal a number of files and a further 
directory called Programs. Open this 
directory with a simple double-click, and you 
will find all the programs for that issue of 
RISC User, most of them in the form of 
applications, 


Taking this one stage further, Shift-double- 
click on any of these applications to reveal 
the files that it contains. One of these 
(usually called !RunImage) is the program 
itself, and this can be modified within Basic. 
The easiest way to do this is to install the 
BEdit utility from RISC User Volume 3 Issue 
4. Alternatively, exit from the Desktop by 


DEF FNten pressing F12, type Basic at the star prompt. 

*FX3,0 Then use the *DIR command to locate and 

vbu2,1,10,3 open the Programs directory, and load the 

*FX3,10 program in as normal. 

=0 Alan Wrigley %U 
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BEEBUG SCAVENGER 


The Beebug Scavenger image scanner adds life to Desktop Publishing, Word Processing, Drawing and Painting, and many 
other activities, Just some of the possible uses are: 


a . rs he Hewlett-Packard DeskJet Plus Immediately on top of 

« Incorporating photographs and drawings into text documents, printer uses ink jet technology to obtain the collecting tray for | 
‘ + ss. . ‘an output quality approaching that of the This latter uses a mecl 

° Scanning pictures to use them as templates for line drawings. laser printer. Yet it costs only a fraction of each emerging sheet until 


‘ thine Hi the price, weighs a mere 14 Jb (the and then drops it onto 
J Creating artwork for exciting title (eo Pendconie KX-P4460 laser printer weighs (act) p in feveren order 
» Scanning photos and text to make a graphical database. 


56 Ib), and requires a minimum of The reason for the ¢ 
maintenance presumably to prevent ii 
s being smu 
arrival of t 
have to 
experienced 
during tests 
graphics 
noticeably da 
some signs 
wrinkling of t 


Scavenger consists of a professional quality scanner, a 
half-width interface card, and a comprehensive user 
guide covering installation, use, hints and tips, 
technical information and routine maintenance. 


Scavenger is available with two different scanners. 


For most users the Tho Desk 
both serial 
half-width scanner, interfaces, a 


capable of reading an Archimedes 
image up to 105mm 
wide, will be suitable. 
If you find your 
requirements grow, 
you can upgrade to the 


He ebccen z 
The Wimp-based software to 
operate the Beebug Scavenger 
is incorporated ina ROM on 
the interface podule. 
Scavenger is operated from the 


full A4 width device, Mae A 

Scavenger A4, which sktop, and you can choose 

can scan a 216mm whether you want the software 
to install itself automatically on 


the icon bar, or whether you 
wish to start it manually 
through a star command. Just some of the features 
offered by the software are: 


Price Stock Code 
Scavenger £194.95 0730G 


Scavenger 3000 £219.95 0735G 
Scavenger A4 £439.95  0731G * Variable image size, with the maximum width being 
Scavenger 3000 A4 £469.95 0733G limited by the scanner, and the depth limited only by the 


Sheetfeeder for A4 models £179.95  0732G 
All prices include VAT. Carriage on these items is £7. 
The Archimedes models of Scavenger are available now, 
the AS3000 models will'be available in July. 


available memory. 
© Real-time display into a window as the image is scanned, 
« Save the scanned image as a sprite or as a bit-image Draw 
file. 


To obtain the greatest scanning precision, a sheet » Conversion of dithered monochrome image to sixteen 
feeder can be added to Scavenger A4. This is fully grey levels. Ideal for enhancing photographs. 
automatic and can scan an entire A4 page under » Full control of optional sheet feeder to allow automatic 
software control in just 15 seconds. scanning. 


Technical Specification 

Maximum image width: 105mm for Handheld models; 216mn¥for A4 models. 

Maximum image depth: Limited only by available memory 

Resolution: 100, 200, 300 and 400 dots per inch for handheld model; 200 dots per inch for A4 model 
Scanning mode: Reflective with CCD sensor 

Dropout Colour: Yellow-Green (570nm) 


Operational modes: Black and white or 16 grey levels for A4 model; 

Black and white or choice of three patterns of 32 grey levels (focusing, dot and mean) for the Handheld model 
Interface: Half-width expansion card, fitted internally to Archimedes, or in external case (supplied) to A3000 
Power Source: Internal for Archimedes; from external unit (supplied) for A3000 
Computer requirements: _ Either an A3000 or an Archimedes with RISC OS, a podule backplane and at least 1 Mbyie of RAM 
Software: ROM-based Desktop application 


